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Sixth Edition (December 1975) 


This is a major revision of, and obsoletes, SC21-7507-4 and Technical Newsletters 
SN21-7738, SN21-7759, and SN21-5255. Information for the Model 12 RPG I 
Compiler has been added. Changes are indicated by a vertical line to the left of the 
change. New or extensively revised illustrations are indicated by a bullet (@) to the 

left of the figure title. Appendix I has been added and should be reviewed in its entirety. 


This edition applies to the following IBM System/3 RPG II program products: 


Version Modification Program Number System/3 Model 
1 14 5701-RG1 10 Card 

15 0 5702-RG1 8 and 10 Disk 
15 0 5703-RG1 4 and 6 

6 0 5704-RG1 15A, B,C 

2 0 5704-RG2 1SD 

4 0 5705-RG1 12 


This revision remains in effect for all subsequent versions and modifications unless 
specifically altered by a new edition or a technical newsletter. Changes are 
continually made to the specifications herein; before using this publication in 
connection with the operation of IBM systems, consult the latest /BM Syvstem/3 
Bibliography, GC20-8080, for the editions that are applicable and current. 


Use this publication only for the purposes stated in the Preface. 


Publications are not stocked at the address below. Requests for copies of IBM 
publications and for technical information about the system should be made to 
your IBM representative or to the IBM branch office serving your locality. 


This publication could contain technical inaccuracies or typographical errors. Use 

the Reader’s Comment Form at the back of this publication to make comments 

about this publication. If the form has been removed, address your comments to IBM 
Corporation, Publications, Department 245, Rochester, Minnesota 55901. Comments 
become the property of IBM. 


©Copyright International Business Machines Corporation 1969, 1970, 1971, 1972, 1973, 1975 


This reference manual is intended primarily for the System/3 
user who has little or no experience with telecommunications 
programming. 


. This manual provides information a programmer needs to 
write System/3 RPG IJ telecommunications programs. 
It contains a: 


@ Definition of basic telecommunications terms 


@ Statement of the telecommunications capabilities of 
System/3 


@ Description of each of the RPG Telecommunications 
Specifications required to write a telecommunications 
program for System/3 


Sample programs are included in this manual to illustrate 
programming techniques and possible applications for 
System/3 RPG II telecommunications programming. 


System/3 Model 8 


The System/3 Model 8 is supported by System/3 Mode! 10 
Disk System control programming and program products. 
The facilities described in this publication for the Model 10 
are also applicable to the Model 8, although the Model 8 is 
not referenced. However, the Integrated Communications 
Adapter (ICA) is available only on the Model 8. If you have 
the ICA, it is always designated as BSCA line 2. Therefore, 
you must enter the BSCA OCL statement (// BSCA LINE-2) 
at execution time. It should be noted that not all devices 
and features which are available on the Model 10 are 
available on the Model 8. Therefore, Model 8 users should 
be familiar with the contents of JBM System/3 Model & 
Introduction, GC21-5114. 
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Preface 


IBM SYSTEM/3 5448 DISK STORAGE DRIVE 


The IBM System/3 5448 Disk Storage Drive on System/3 
Models 8 and 10 uses the same program product support 
as the IBM 5445 Disk Storage. However, a separate 
system control program feature is required for the 5448. 
In general, references to 5445 in this manual also apply 
to 5448. For specific information about 5448 operating 
characteristics and programming support, see /BM 
System/3 5448 Disk Storage Drive Program Reference 
Manual, GC21-5168. 


ii 
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Related Publications 


The following chart lists the order numbers of the various 


related publications. 
Model 10 Model 10 
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IBM System/3 Telecommunications programming provides 
the user with the capability of sending and receiving binary 
synchronous data over common carrier facilities. The pro- 
gramming performs all functions necessary to establish line 
connections, exchange identification sequences, send and 


receive data, and execute the correct termination or discon- 


nect procedures. 

System/3 RPG II telecommunications support is provided 

via the RPG II language. Binary synchronous data trans- 

mission is possible between System/3 and: 

@ Other System/3s. 

© Operating System or Disk Operating System Basic Tele- 
communications Access Method Binary Synchronous 


Communications (OS or DOS BTAM BSC). 


@ System/360 Model 20 Input Output Control System for 
the Binary Synchronous Communications Adapter. 


®@ Operating System Telecommunications Access Method 
(TCAM). 


@ IBM 3741 Model 2 Data Station. 
@ IBM 5230 Model 2 Data Collection Controller. 
© IBM 3750 Switching System (World Trade only). 


@ IBM System/7. 


Page of SC21-7507-5 
Issued 24 September 1976 
By TNL: SN21-5428 


Introduction 


The System/3 Model 10 Disk System, Model 12, Model 6, 
Model 8, and Model 15 can also transmit data to and receive 
data from the IBM 2770 Data Communication System and 
the IBM 2780 Data Transmission Terminal (see Appendix E). 


BSCA files are defined by entries on the RPG File Descrip- 
tion Specification and the RPG Telecommunications Speci- 
fication. 


Note: For use of the second BSCA feature, see the /BM 
System/3 Model 10 Disk System Control Programming 
Reference Manual, GC21-7512, IBM System/3 Model 12 
System Control Programming Reference Manual, 

| GC21-5130, or JBM System/3 Model 15 System Control 
Programming Reference Manual, GC21-5077. 


A System/3 RPG II telecommunications program can exist 
within a dual programming system (Dual Programming Fea- 
ture required). Normal operator attention is required to 
respond to processing halts. 


Note: If you are attempting to communicate between 
two programming levels using the RPG II telecommunica- 
tions features and dual BSCA, it is suggested that you do 
not have overlays in either of the RPG II programs. 


For IBM System/3 telecommunications operating procedures, 
see your system’s operator’s guide. 


Introduction 1 


Nw 


BSC Telecommunications Concepts and Terminology 


This section describes the basic characteristics and opera- TELECOMMUNICATIONS NETWORKS 

tonal concepts of the BSC telecommunications system: 

what it is, how its parts are related, and how control is A telecommunications system may use a nonswitched net- 
maintained. Commonly used terms are italicized, work or a switched network (Figure 1). 
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Figure |. Telecommunications Networks (Part | of 2) 
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System/3 
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la. ‘ iSotes : 
Phe Integrated Communications Adapter (ICA) must be addressed 
as BSCA line 2. The manual ICA switch can have only one interface 
active at any one time. 


2 See Figure | (Part 1 of 2) tor examples of BSCA line configurations. 


Figure 1. Telecommunications Networks (Part 2 of 2) 


Nonswitched Network 


A nonswitched network consists of a number of private or 
leased communication lines that connect a computer to one 
or more remote rerminals, Remote terminals is a general 
term used to represent interconnected equipment at a 
remote location, having either input or output capability, 

or both. On nonswitched networks, the computer and 
remote terminals are physically connected, that is, the 
circuits making up the communication lines are continuously 
established for predetermined time periods, during which 
data may be transmitted over the lines. 


The lines that comprise a nonswitched network are variously 
known as private, leased, or dedicated lines. These lines 
may be furnished by a common carrier on a contract basis 
between specified locations for a continuous period or for 
regularly recurring periods at stated hours, for the exclusive 
use of one customer, 


In this publication the term nonswitched network refers to 
a network in which the communication lines linking the 
computer and the remote terminal are continuously estab- 
lished, thus requiring no dialing to establish the connection. 


Switched Network 


A switched network allows many remote terminals to 
communicate with a computer without requiring dedicated 
communication lines. The computer and the remote termi- 
nals are connected by access lines to the common carrier 
exchange serving their respective locations. A complete 
and continuous data path is established between the com- 
puter and the remote terminal only for the period of time 
in which data transmission takes place. The connection is 
established by dialing the telephone number of the remote 
terminal. 


In switched networks, line refers to a discrete data path 
between the telecommunications control unit, or adapter, 
and the common carrier exchange. The service provided by 
the common carrier is usually on a time-used basis. 


In this publication, the term switched network refers to any 
network in which a direct physical connection between the 
computer and the remote terminal must be established by 
dialing in order for data transmission to occur. 


NETWORK CONTROL 
Initial contact between a computer and a remote terminal 


may occur in two ways, dependent on the type of line 
connection between them. The connections possible are 


multipoint, on nonswitched lines, and point-to-point con- 
tention, on both switched and nonswitched lines. The 
BSC telecommunication system permits communication 
using either type of connection (Figure 1). 


Multipoint 


Ifa remote terminal is connected via a multipoint line, data 
is sent and received under the control of the central or 
control station. In order to send or receive data, the remote 
terminal, referred to as a mudtidropped terminal or tributary 
station, must be selected by the control station. This pro- 
gess of station selection is called polling or addressing. 


Note: System/3 cannot be a control station, 


Polling: Polling is a request to a tributary station to trans- 
mit data to the control station. Once the bributary station 
has accepted the invitation, thru recognition of its unique 
polling characters sent by the control station, the remote 
terminal may use the line to send data. 


The tributary station notifies the control station when data 
transfer is complete by sending a unique /nd-of- Transmission 
(EOT) character to the control station. (For more informa- 
tion on control characters, see Data Link Control in this 
section.) Upon receipt of the EOT sequence, the control 
station may poll or address another tributary station, 


Addressing: Data transfer from the control station to the 
tributary station on a multipoint network is accomplished by 
addressing the selected tributary station. Addressing is a 
request to a tributary station to receive data. 


The control station notifies the tributary station when data 
transfer is complete by transmitting the EOT sequence. 
After EOT has been sent, the control station polls or 
addresses other tributary stations connected via the multi- 
point network. 


Only the control station has the right to request data 
transfers on a multipoint network. 

Point-to-Point 

The other type of line connection is point-to-point con- 


tention, with the computer and the remote terminal connected 
via a nonswitched or switched line. 


BSC Telecommunications Concepts and Terminology — § 


Non-Switched: On a nonswitched line, either the computer 
or the remote terminal may initiate the transmission of data. 
However. if both stations simultaneously attempt to transmit 
or receive data, the line is disconnected. 


Switched: On a switched line, one of the stations is desig- 
nated as the calling station. The other stations, or called 
stations, accept calls from the calling station. The calling 
station may perform the calling sequence by either autocall 
(automatic dialing by the computer) or manual dial (dialing 
performed by the machine operator). The called station 
accepts calls from the calling station by either autoanswer 
(automatic answering by the computer) or manual answer 
(machine operator makes the data set ready). 


The calling station must initiate data transmission by sending 
the proper control sequence to ensure that a connection 

has been made with the desired station. The control se- 
quence usually involves the exchange of station identification 
sequences. When station identification sequences are used, 
data transmission will not begin until both the called and 

the calling station have sent and received the correct ID 
sequence. 


When the control sequence has been completed, the calling 
station may either send data to the called station, or may 
relinquish the right to send data by sending an End-of-Trans- 
mission character. Once the EOT has been sent, the called 
station may initiate sending data to the calling station. When 
both stations have completed sending data, the calling station 
starts a disconnect procedure to terminate the data link. 


DATA LINK CONTROL 


Data link control procedures are used to ensure the proper 
sending and receiving of data between the computer and the 
remote terminal. System/3 BSCA support assumes the 
responsibility for maintaining the proper data link control 
procedures. 


The following information is presented to provide the 
System/3 programmer with sufficient information to 
properly utilize the BSCA capabilities. 


Data Link Control Characters 


Data link communication control between stations, that is, 
between the computer and the remote terminal is main- 
tained by the use of Data Link Contro] Characters 
(Appendix B). 


By using data link control characters, the computer and 

the remote station notify each other of their status, and 

the status of data sent or received by them. During normal 
operation, the data link characters cannot be included in the 
data being sent or received. 


Data Link Message Codes 


The BSC adapter is capable of sending or receiving data in 
one of two codes: EBCDIC (Extended Binary Coded Deci- 
mal Interchange Code) or ASCII (American National Stand- 
ard Code for Information Interchange). The code you use 
is determined by the type of BSC adapter installed in your 
system. 


EBCDIC and ASCII character code charts are provided in 
Appendix A of this manual. 


DATA LINK MESSAGE FORMATS 
Standard Format 


The standard message format consists of characters of data 
from the code selected, excluding specially designated data 
link control characters. 


EBCDIC Transparency 


BSC adapters with the EBCDIC transparency feature in- 
stalled may send and receive messages containing any or all 
of the possible 256 character combinations in the EBCDIC 
code, including data link control characters. This feature 
allows unique data, such as packed decimal data, to be 
sent unaltered from one computer to another. 


Intermediate Block Checking Mode (!TB) 


The intermediate block checking feature allows large 
buffers of data to be sent and received with parity checking 
performed on each logical record rather than the total 
buffer. The ITB character delimits logical records within 
the buffer. 


System/3 RPG IH Telecommunications Programming pro- 
vides the RPG II user with the capability of transmitting 
and receiving binary synchronous data via a telecommuni- 
cations network. BSCA support is achieved through the 
use of an RPG Telecommunications Specifications Sheet 
and the addition of BSCA as a valid device entry on the 
RPG File Description Specification. No other RPG speci- 
fication sheets are affected by BSC. 


BSCA STATION TYPES 


RPG II permits System/3 to function as any of the following 
station types: 


l. Receive only (receive input data from a remote 
terminal). 

2. Receive with transmittal of conversational reply 
(receive input data from a remote terminal and, 
when required, transmit data as an acknowledgement). 


RPG II BSCA Programming 


3. Transmit only (transmit data to a remote terminal). 

4. Transmit with reception of conversational reply 
(transmit data to a remote terminal and, when required 
receive data as an acknowledgement). 

5. Transmit and receive—no conversational reply. Three 
modes of operation are possible: 


> 


a. Transmit a file, then receive another file. 

b. Receive a file, then transmit another file, 

c. Transmit records of a file interspersed with receiv- 
ing records of another file. (This function is avail- 
able only when System/3 transmits data to OS or 
DOS. System/3 must transmit first.) 


A description of these functions, including complete RPG II 
programs, are provided following the description of the 
specification sheets. 


Note: Each telecommunications program implies a counter- 
part at the other end of the line. The two programs must be 
compatible. For example, a program which transmits 

ASCH data requires a program which will receive ASCII 
data. 
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RPG Il TELECOMMUNICATIONS SPECIFICATIONS 


The RPG Telecommunications Specifications Sheet (Figure 
2) permits the RPG IT programmer to enter the information 
necessary to establish and maintain the BSC communica- 
tions link. Each BSCA file defined on the RPG File De- 
scription Specifications Sheet must have a corresponding 
RPG Telecommunications Specifications Shect. 


Columns 1-2 (Page) 


Entry Explanation 
01-99 Page number. 


Columns 1-2 in the upper right corner of the specifications 
sheet are used to indicate the page number. The Tele- 
communication Specifications must follow the File Descrip- 


tion and any File Extension and Line Counter Specifications 


Sheet: 


RPG TE LECOMMUNICATIONS SPECIFICATIONS 


son lo: 
| Progrant ca See ee Punching pas i 
| Prog atnier | Date Instructors - : 
‘ tehe 


Iden 





Columns 3-5 (Line) 


Entry Explanation 


Any number Line numbers. 


Columns 3-5 are used to number the lines on the page. 


Columns 3-4 are preprinted, so in most cases line numbering 
is done for you. 


Column 6 (Form Type) 


Lntry Explanation 


T Column 6 must contain a T. T identifies this 
page as a Telecommunications Specification. 
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Column 7 (Comments) 


Entry Explanation 


* Comments line. 


You often want to write comments that will help you 
understand or remember what you are doing in a certain 
section of coding. RPG II allows you to use an entire 

line for these comments. The comment line is identified 
by placing an asterisk (*) in column 7. Comments are not 
instructions to the RPG II program. They serve only asa 
means of documenting your program. 


Columns 7-14 (File Name) 


Entry Explanation 


alphameric = This entry must be the same as the file name 
associated with the BSCA device on the File 


Description Specifications Sheet. 


Column 15 (Configuration) 


Entry Explanation 

P or blank Point-to-point, nonswitched network (PTP). 

M Multipoint network, where the control sta- 
tion selects the tributary station through 
polling or addressing. System/3 cannot be 
the control station. 

Ss Switched network. 


Column 16 (Type of Station) 


Entry Explanation 

T This station will transmit messages from this 
file (transmit only or transmit with reception 
of conversational reply). The file must be 
designated as an output or combined file on 
the File Description Specifications Sheet and 
must appear on the Output Format Specifica- 
tions Sheet. 


R This station will receive messages into this file 
(receive only or receive with transmittal of 
conversational reply). The file must be desig- 
nated as an input or combined file on the File 
Description Specifications Sheet and must 
appear on the Input Specifications Sheet. 


! Note: This entry is independent of the entry in column 20. 
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Column 17 (Type of Control) 


Entry Explanation 

T This is a tributary station on a multipoint 
network. System/3 cannot be the control 
station and transmit the polling supervisory 
sequence. 

blank Polling is not used. 


Column 17 must contain a T if column 15 contains an M 
(multipoint network). 


Column 18 (Type of Code) 


Entry Explanation 

A, U ASCII (formerly referred to as USASCII) data 
link control characters will be used. When 
ASCII is used, each station must provide file 
translation when it is required. 

E or blank EBCDIC data link control characters will 


be used. 


The entry in this column must be the same type that your 
BSCA and RPG II program supports. ASCII and EBCDIC 
codes are listed in Appendix A. 


Note: If your BSC program halts because of an invalid 
ASCII character in your data, check your ASCII translation 
table. 


Column 19 (Transparency) 


Entry Explanation 
Y This entry is valid only for EBCDIC. The 
transparency feature must be installed. 


The data being transferred may contain data 

link control characters. EBCDIC data link 

control characters are listed in Appendix B. 
Nor blank The transparency feature is not used. Un- 
packed numeric or alphameric data will be 
transmitted and received. The data being 
transferred may not contain data link control 
characters. 
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Column 20 (Switched) 


Entry 


M 


blank 


Explanation 


The computer operator using this program makes 
the connection between stations by dialing the 
number (manual dial). 


Autocall is to be used by this station. The dial 
number is listed in columns 21-31. 


Autocall is to be used by this station. The entry 
in columns 21-31 is the symbolic location of 
the dial number. 


Autoanswer is used by this program. 

Manual answer is used by this program. 

This is not a switched network. 

Notes: 

1. When calling, you should use E, M, or S. If 
the program is to be called, you should use A 


or B. That is, if two RPG II programs are 
communicating, one program must have an 


E, M, or S, and the other must have an A or B. 


2. This entry is independent of the entry in 
column 16. 


Columns 21-31 (Dial Number) 


Entry 


numeric 


alphameric 


10 


Explanation 


This is the number to be dialed when column 
20 contains an E. 


Columns 21-31 must contain a symbolic 
name, other than an array name, referencing 
the location of the dial number when column 
20 contains an S. If the BSCA file is an input 
file other than a demand or conversational 
receive file, this name must refer to the first 
(or only) element of a table. This ensures 
that the dial number will be in storage before 
the telecommunications line is opened. 

(This restriction does not apply when the 
function of the program is transmit with 
conversational reply.) 


Column 32 (Location of Identification—This Station) 
Entry Explanation 


S Switched network. This station’s identification 
is located at the position referenced by the 
symbolic name specified in columns 33-39. 


E Switched network. The entry in columns 33-39 
is this station’s identification. 


blank This is a nonswitched network or a switched 
network where no ID is desired for this station. 


Columns 33-39 (Identification—This Station) 


Entry Explanation 

alphameric When column 32 contains an E, this entry 
is the actual identification sequence of this 
station (minimum two characters). 


When column 32 contains an S, this entry is 
the symbolic name of the location of this sta- 
tion’s identification. The symbolic name 
must not be an array name. If the BSCA file 
is primary or secondary, this symbolic name 
must refer to the first element of a table. 
(The table may have only one element.) This 
ensures that the station identification will be 
in storage before the telecommunications 
line is opened. 


The station identification can be from two to 
fifteen characters; however, the length of 
this field or literal must be the same as the 
length of the field or literal in columns 
41-47 (blanks in literals do not count as 


part of the length). A station identification 
must not contain a control character sequence 


(see Appendix B). The station identification 
will be translated if the BSCA files are being 
translated. 


Column 40 (Location of Identification—Remote Station) 
Entry Explanation 


S Switched network. The remote station’s 
identification is located at the position 
referenced by the symbolic name specified 
in columns 41-47. 


E Switched network. The entry in columns 
41-47 is the remote station’s identification. 


blank This is a nonswitched network or a switched 
network where no ID is desired for the remote 
station. 


Columns 41-47 (Identification— Remote Station) 
Entry Explanation 


alphameric © When column 40 contains an E, this entry 
is the actual identification sequence of the 
remote station (minimum two characters). 
When column 40 contains an S, this entry is the 
symbolic name of the location of the remote 
station’s identification. The symbolic name 
must not be an array name. If the BSC file is 
primary or secondary, this symbolic name must 
refer to the first element of a table. (The table 
may have only one element.) This ensures that 
the station identification will be in storage 
before the telecommunications line is 
opened. The station identification can be 
from two to fifteen characters; however, 
the length of this field or literal must be 
the same as the length of the field or 
literal in columns 33-39 (blanks in literals 
do not count as part of the length). A 
station identification must not contain a 
control character sequence (see Appendix 
B). The station identification will be 
translated if the BSC files are being 
translated. 
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Columns 48-51 (Remote Terminal) 


Columns 48-51 are used only if System/3 is to communicate 
with the IBM 2770 Data Communication System or the 
IBM 2780 Data Transmission Terminal (see Appendix E). 
Otherwise, columns 48-51 are never used with System/3 
and must be blank. 


Column 52 (ITB) 

Entry Explanation 

I Intermediate block check (ITB) is used. 

blank ITB is not used. 

Intermediate block checking can be used only if records 

are blocked. 

Columns 53-54 (Permanent Error Indicator) 

Entry Explanation 

01-99,L1-L9 A permanent error indicator should be used 

LR,H1-H9 with every BSC file. If you are using more 
than one BSC file, each should have a per- 


manent error indicator, not necessarily 
unique. 


When a permanent error occurs, the specified 
error indicator and the identification indica- 
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tor of the record causing the error are both 
set on. The permanent error indicator should 
be used to condition appropriate program- 
ming response (for example, printing a mes- 
sage or performing a controlled cancel). No 
further transmission should be attempted 
while the permanent error indicator is on. 


If you are using dual I/O buffers on the 
Card System and a permanent error occurs 
when the first record is received, a system 
halt is issued automatically. 


Disk systems only: To retry an operation 
after a permanent error occurs, turn off the 
permanent error indicator. The RPG II pro- 
gram can then access the BSC file that 
caused the error. If no error occurs, pro- 
cessing continues; otherwise the permanent 
error indicator is turned on again. 


Keep the following points in mind when you 
retry an operation: 


1. The permanent error indicator is the 
only indication given to the RPG II 
program that an error has occurred. 


2. Any data in the BSC buffers at the 
time of an error is lost. 


3. Switched lines are not disabled when 
an error occurs except for disconnect 
sequence received or hardware de- 
tected disconnect. 


4, Any data passed to the user while the 
permanent error indicator is on is 
invalid. Unless your program recog- 
nizes all data, an unidentified record 
halt may occur. 


5. Alimit should be imposed by the 
RPG II program on the number of 
times an error occurs before stopping 
the program. 
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blank No permanent error indicator is specified. 


If a permanent error occurs on a card or disk 
system when no permanent error indicator 
has been specified, a system halt occurs. The 
program cannot be restarted. 


Note: Avoid using H1-H9 as permanent error indicators if 
you wish to condition operations on the permanent error 
indicator being off. Since H1-H9 are reset at the end of 
the detail cycle, they may be set off before the program 
cycle in which the error occurred is completed. 


Also, when H1-H9 is used as a permanent error indicator, 
the H1-H9 display may preempt the system halt display. If 
the H1-H9 display appears before the system display, dial 
the O option on a disk system or restart the card system to 
prompt the system halt display. 


Columns 55-57 (Wait Time) 


Entry Explanation 

numeric The length of time in seconds, 1-999, that BSC 
will wait with no messages being sent or re- 
ceived before a permanent error condition 
occurs. 

blank The system convention for timeout, 180 


seconds, is used. 


A permanent error results whenever the wait time elapses on 
an idle line. Therefore, when you determine your wait time, 
consider time the operator may require to respond to halts 
and other processing interruptions, and also time the program 
may require for special operations such as table searches, 
computing square roots, etc. 


Note. The time limit specified applies only to delays 
caused by this System/3 program and does not apply to 
the remote device. If the remote device does not commun- 
icate with this System/3 within a 20-second period, a 
permanent error condition occurs. In addition, the time 
limit applies only during the transmission of a file, not 
between file transmissions. The occurrence of a permanent 
error indicates the end of processing of a file. 


Columns 58-59 (Record Available Indicator) 


Entry 
01-99, 
L1-L9, 


LR, 
H1-H9 


Column 60 
Entry 


L 


blank 


Explanation 


A record available indicator should be assigned 
to every BSCA input file that is to be reopened. 
(If a file is used again after end-of-file has been 
reached, the file is ‘“‘reopened.”) See Figure 9 
and Appendix F for examples using a record 
available indicator. This indicator is set on 
whenever a reverse interrupt (RVI) is received. 


(Last File) 

Explanation 

This BSC input file is processed only after all 
other primary and secondary input files have 


been processed. 


It isn’t necessary that this BSC input file is 
the last input file processed. 


Columns 61-62 (Polling Characters) 


Entry 


Alphameric 


blank 


Explanation 


The polling identification of this station is 
needed if this station is part of a multipoint 
network and the BSC file is a transmit (out- 
put) file. Polling characters are listed in 
Appendix C, 


This station is not transmitting ona 
multipoint network. 


Columns 63-64 (Addressing Characters) 
Entry Explanation 

Alphameric The addressing identification of this station 
is needed if this station is part of a mullti- 
point network and the BSC file is a receive 
(input) file. Addressing characters are 
listed in Appendix C. 


blank This station is not receiving on a multipoint 
network, 


Note: Enter polling and addressing characters in System/3 
code; the compiler will convert the characters to the form 
required by the code specified in column 18. 


Columns 65-70 (Remote Device) 


Columns 65-70 are used only if System/3 is to communicate 
with the IBM 2770 Data Communication System or the 
IBM 2780 Data Transmission Terminal (See Appendix E). 
Otherwise columns 65-70 are never used with System/3 and 
must be blank. 


Columns 71-74 (Reserved) 


Columns 71-74 ure never used with System/3 and must be 
blank, 


Columns 75-80 (Program Identification) 


Columns 75-80 may contain any characters. These columns 
may use the program name in the control card. or they may 
coutain characters which identify a certain portion of the 
program. The entry is ignored by the compiler. but will 
appear in the source program listing. 


FILE DESCRIPTION SPECIFICATION ENTRIES FOR 
BSC FILES 


The entries in the columns listed below are used to define 
a BSCA file on the RPG File Description Specifications 
Sheet. The entries in columns not listed are the same as 
basic RPG. 


No other RPG specification sheets are changed by BSC. 
However, since a BSC program must not be interrupted, a 

B must not be entered in column 37 of the RPG II Control 
Card Specifications when the BSC program is to be run on a 
disk system. 


Columns 7-14 (File Name) 


This is the name of a BSC file. The same file name must be 
used on the RPG Telecommunications Specifications Sheet. 


Note: Look-ahead fields must not be specified for a BSC 
file. 


Column 15 (File Type) 


Entry Lxplanation 

l This is an input (receive) file. 

O This is an output (transmit) file. 

Cc Combined file. Use C when your receive file 


or transmit file uses conversational reply. Un- 

like combined card files, the acknowledgement 
sent us a conversational reply may or may not 

be added to the last record received. 


C isan invalid entry ifan IBM 2770 or IBM 
2780 is being used. 
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Column 16 (File Designation) 
This is the same as basie RPG except that: 


hi: D (demand file) is the required entry for transmit 
interspersed with receive. BSCA files also should be 
designated as demand files with any receiving program 
which does not address the BSCA files immediaiely. 
For example, i! your BSCA file is defined as a sec- 
ondary file, the telecommumnications line will be 
opened as soon as the program begins. This means 
that your wait time may elapse before you are ready 
to process the BSCA tile. If the BSCA file is defined 
as u demand file, however, the line will be opened 
only when the program is ready to receive from the 


BSCA file. 


to 


R (record address file) is an invalid entry. A BSCA 
file cannot be u record address file, 


Column 17 (End of Fite) 


Enter an E ifend-orfile on the input (receive) file is to de- 
termine end-of-job. The BSCA input file can be the only 
file with an Ein column 17. UW any other Input Ale has an 
E specified in column 17, then all BSCA input files should 
have an Ein column 17. The Ein column 17 is not man- 
datory. but without it when end-of-file is reached on the 
other file. the BSCA file will be closed without giving the 
system ou the other end an indication of what has 
happened. By using the E in column [7 tor all BSCA 
input files, all systems will come to a successful end-of-job. 


Column 19 (File Format) 


Enter an F (fixed length) for BSCA files. 


Columns 20-23 (Block Length) 

Enter the size of the blocks of data to be processed by 

BSC. If your BSCA files use conversational reply. block 
length must be the same as record length: otherwise. block 
length can be a multiple of record length. The maximum 
block lengths are 4096 (Model 10 Curd System) and 9999 
(Model 6, Model 10 Disk System. Model 12. und Model 15). 


Columns 24-27 (Record Length) 
Enter the length of your BSCA iecords. right justified. in 
columns 22-272 bE your BSCA 


eneth mist be the seme as bloek deneih. EP 





Suse Conversational re- 





ply. record 
you do noi specily a record feneth. the record leneth will 
be defaulicd to zero. The manimuni record lengths are 

4096 (Model 10 Card System) und 9999 (Model G. Mode! 


10 Disk System. Mode] 12. and Model |S). 


Note: When the transmitted record is less than tie record 
length specification fieid a te program. the data in ihe 


remainder of the bulfer may cause unpredictable: results. 


Column 32 (Additional Area) 





Assign dual [/O areas. This column is used oily we 
i 


conversational BSCA tiles. Any number. } tarourh & causes 
two 1/O areas to be assigned. Hf this column is bhutik. wails 





one 1/O area is assigned and throughput is decreased aecoud- 


ingly. 


Columns 40-46 (Device) 
The device entry for BSCA tiles is BSCA. 


Note: On the Model 10 Disk System. Mode! 12, Model 6 
and Model 15, the maximum number of non-BSCA Tiles 

allowed in a program using BSCA files depends upon the 
number of BSCA files: 


Maximum number of 
non-BSCA files allowed 


19 


Number of BSCA files 
in program 


i fa ss 

















DESCRIPTIONS OF BSC FUNCTIONS 


This section describes the functions that System/3 can per- 
form as part of a telecommunications network. Complete 

RPG I] programs are included to show how these functions 
may be used. 


Programming Considerations 


RPG II First-Time Logic 


RPG II first-time logic opens all primary and secondary in- 
put files during the first-time cycle. That is, one record is 
read from each primary and secondary input file before 
any input file is processed. However, depending upon the 
particular application, you may want to delay first-time 
logic for your BSCA input files. You can achieve this by 
designating cach BSCA input file as a demand file (D in col- 
umn 16 of the File Description Specification sheet), One 
BSCA input file can also be designated as the last file (L in 
column 60 of the Telecommunications Specification sheet). 


Remember that an entire BSCA input file must be received 
before another, or part of another, BSCA input file can be 
received. 


Control Breaks and Overflow 


Care must be taken when transmitting data at total time in 
any RPG IT program which both transmits and receives. 
Due to the sequence of total and detail operations in the 
RPG II Program Cycle, data may not be available for output 
even though it has been read. 


Similar cure must be taken when assigning the overflow 
indicator in a program that both transmits and receives. A 
potential problem exists in that RPG Il, because of the pro- 
gram cycle, may try to transmit an overflow record after 
receiving a record. 
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Data Restrictions 


@ Remember that /* in the first two positions of a record 
always signifies end-of-file. This applies even to data 
transmitted and received ina BSC program. Therefore, 
be sure that the use of literals, constants, or OS or 
DOS data records does not result in the transmission 
ot /* in the first two positions of a record. 


Note: When a table is dumped, a /* is generated to denote 
the end of the tabic. Therefore, if you dump a table toa 
BSCA file, expect an end-of-file condition when the table 
has been received. 


e@ Ifyou have the auto-turnaround feature and you are 
communicating in transparent mode to the [BM 2780, 
the last record received by System/3 before turning the 
line around will be blank. Consider this when you spec- 
ity record identifiers in the RPG input specifications. 


Details of transmitting data sets on the 3741 can be found 
in the /BM System/3 3741 Models 3 and 4 Programmable 
Work Station Programming Reference Manual, GA21-91 94, 
or IBM 374] Data Station Reference Manual, GA2\-9183. 


Data Formats 


System/3 RPG If support uses the following data formats 
for transmission of data--these formats must be used when 
sending data to System/3 from a CPU. The BSCA support 
provides these for the RPG I user. 


@ Non-transparent, non-ITB: 
STX-data-ETX (ETB) 


@ Non-transparent, ITB: 
STX-data-ITB-data-IT B-data-ETX (ETB) 


@ Transparent, non-ITB: 
DLE-STX-data-ETX (ETB) 


@® Transparent, ITB: 
DLE-STX-data-1fB-DLE-STX-data-ITB-DLE-STX-data- 
LETX (ETB) 


Notre. BTAM cannot send transparent ITB data, but can 
receive transparent ITB data. 


Data can be either fixed length and unblocked, or blocked 
with fixed record length. If ITB mode is used, the ITB 
character must precede each record except the first, and 
should not be counted in the record length, 
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Errors 


If an error occurs at either station, System/3 will retry the 
operation a maximum of seven times. 


System/3 halts with a permanent error if it receives: 
e@ An EOT while transmitting 


e The following sequence of data link control characters: 
TTD-NAK-EOT. 


APG I! Diagnostics 


Refer to the RPG II reference manual for your system for 
a discussion of compile time RPG II diagnostics. 


Model 15 Only 


Because the BSCA program is an interrupt driven program 
and cannot be rolled out of its partition, care must be taken 
when using BSCA files with SPECIAL files (where allocation 
of system supported disk devices is performed) or unpre- 
dictable results will occur. To prevent the program from 
being rolled out by allocation, the RPGTCF programmer 
must ensure that the BSCA data management DTFs and 
IOBs are located 6K bytes beyond the beginning of the 
partition. 


Receive Only 


The receive only function allows the RPG II user to receive 
input data from a remote terminal. The file may be either 
a primary or secondary file. Blocked records are permitted. 
Dual I/O areas can be used to achieve greater throughput. 


The receive only file is defined as an input file on the RPG 
File Description Specification and as a receive file on the 
RPG Telecommunications Specification. 


In the following receive only program (Figure 3), a branch 
office is transmitting a daily sales report to System/3. The 
information received is listed on the printer and punched 
and printed on cards. The salesman’s name is sent on one 
record. This record is followed by any number of records 
identifying his sales for the day. The card file produced by 
this and other day’s transmissions can be sorted and used by 
another RPG II program as data to calculate information 
such as inventory control and the salesman’s commissions. 
The same program could then transmit this information 
back to the branch office. 


File Description Specifications (F igure 3, Part 1) 
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Telecommunications Specifications (Figure 3, Part 1) 
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Column — Description Column Description 
7-14 SALES is the file which contains the sales 7-14 SALES is the BSCA file for this program. 
report received by this station. 
/ 15-17 This station is part of a switched network 
15-16 SALES is the primary input file for this (S), and will receive messages (R). Polling is 
program. not used, so column 17 is blank. 
17 End-of-file on SALES does not determine 
end-of-job time. 18-20 EBCDIC code (E) and the transparency 
feature (Y) are both used. Autoanswer (A) 
19 BSCA files always have a fixed length format. is used by the called station, 
20-27 Records are blocked. 32-47 Explicit station identification sequences are 
given for each station. Station IDs ensure 
32 Dual I/O areas are used. data security on the switched network. 
40-46 BSCA is the device used for BSCA files. 32 Intermediate block check (I) is used. 
BSCA is also specified when communicating 
with a device attached via the Local Communi- 
cations Adapter. 
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Figure 3. Receive Only Program (Part 1 of 3) 
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Description 
The permanent error indicator used is 99. 


The telecommunications line will be kept 
open for 120 seconds even though no 
messages are being sent or received. After 
120 seconds have elapsed, a permanent 
error condition results if the line still is 
not being used. 
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INPUT SPECIFICATIONS 


Input Specifications (Figure 3, Part 2) 

Data transmitted by the remote station is received by 
SALES. 

Calculation Specifications (Figure 3, Part 2) 


Ifa permanent error occurs, LR is set on to enter end-of-job 
processing. 
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Output Format Specifications (F igure 3, Part 3) 


AN PerAaneny error causes an 


error Message to be printed. 
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Receive with Transmittal of Conversational Reply 


The receive with transmittal of conversational reply function 


allows the RPG I] user to receive dala and. when necessary, 


to senda record to the remote terminal. Dual {/O areas and 


7-14 


blocking or deblucking of data are not permitted. 


15 


The receive with transmittal of conversational reply file is 
defined as a combined file on the RPG File Description 


Specifications Sheet and as a receive file on the RPG Tele- 


conupunications Specifications Sheet. 


The foewing program (Figure 4) is similar to the receive 


only program: however, the receiving station can now send 
a response to the remote station if the information received 


is incomplete. 
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File Description Specifications (Figure 4, Part 1} 


Description 
SALES is a BSC file. 


SALES is a combined file since it will receive 
data and transmit a conversational reply. 


SALES is the primary input file for this 
program. 


End-of-file on SALES does not determine 
end-of-job time. 


BSC files always have a fixed length format. 


Blocking and deblocking are not permitted 
for conversational BSC files. 


BSCA is the device used for BSC files. 
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Telecommunications Specifications (Figure 4, Part 2) 
Column Description 
7-14 SALES is the BSC file for this program. 


15-17 This station is part of a switched network 
(S) and will receive with conversational 
reply (R). Polling is not used. so column 17 
is blank. 


18.19,20 EBCDIC code (E) is used. but the trans- 
parency feature is not used (N). Autoanswer 
(A) is used by the called station. 


32-47 Explicit station identification sequences are 
given for each station. Station IDs ensure 
data security on the switched network. 


53-54 The permanent error indicator used is 88. 


55-57 The telecommunications line will be kept 
open for 45 seconds even though no mes- 
sages are being sent or received. After 45 
seconds have elapsed, a permanent error 
condition results if the line still is not being 
used. 
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Input Specifications (Figure 4, Part 3) Calculation Specifications (Figure 4, Part 3) 


Line 02, colunins 69-70: If SLSMAN is absent trom a 
record having an N in position 1, indicator 99 js set on. 


Ifa permanent error occurs, LR is set on to enter end-of-job 
processing. 
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Output Format Specifications (Figure 4, Part 4) 


Page 05, lines 15-16: A permanent error causes an error 
message to be printed. 


Page 06, lines 9-11: When indicator 99 is set on, a conver- 


sational reply is sent from SALES. 
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Transmit Only 


The transmit only tunction allows the RPG II user to 
vransmit BSC data to a remote lovation. Dual I/O areas 
and blocking of data can be used to increase throughput. 
The transmit only file is defined as an output file on the 
RPG File Description Specifications Sheet and as a transmit 
ie on the RPG Teleconmunications Specifications Sheet. 


This rransnuit only program (Figure 5) is reading and trans- 
autting the card files produced by the receive only program 
iFigure 3). The week's data has been sorted by salesman 
name. The amount of cach sale has been punched into the 
curds and the total sales for each salesman is transmitted to 
the branch office. After all cards have been read, the total 
of all sales is transmitted, 
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File Description Specification 


CONTROL CARD AND FILE DESCRIPTION SPECIFICATIONS 


File Description Specifications (Figure 5, Part 1} 


Colunin Description 
7-14 WKLYSMRY is a BSCA file. 
15 Since WKLYSMRY is to be transmitted, it 
is an output file. 
19 BSCA files always have a fixed length format. 
20-27 Records are blocked. 
3 Dual I/O areas are used. 
40-46 BSCA is the device used for BSCA files. 
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Telecommunications Specifications (Figure 5, Part 2) Column Description 
Colum Description ce Intermediate block check (1) is used. 
7-14 WKLYSMRY is the BSCA file for this pro- 3 ae ee 
53-54 The permanent error indicator used is 25, 
gram. 
15-17 This station is part of a switched network (S), ese i ; ; 
; sades sat Coe 55-57 Phe telecommunications line will be kept 
and will be transmitting (T). 1 olling is not : 
: open tor 70 seconds even though no messages 
used, so column 17 is blank. ‘| ; aan 
are being sent or received. After 70 seconds 
ican és have elapsed. a permanent error condition 
18-19 EBCDIC code (£) and the transparency f ae ms 
: : results if the line still is not being used. 
feature (Y) are both used. 
20-3 | Autocall is used (S). and columns 21-31 sie al . ee 
: af : ) . : : Input Specifications (Figure &, Part 1} 
contain the symbolic location of the dial 
number. : san ae : i 
i Lines 07-03: The tirst card read contaiis the dha: number 
; : . i : . of the remote station and Soth station ite 
32-47 Symbolic locations are given for each station 


ea Loh sequences. 
identification sequence. Station IDs ensure 


data security on the switched network. 
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Figure S, Transmit Only Program (Part 2 of 3) 
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Calculation Specifications (Figure 5, Part 3) 


If a permanent error occurs, LR is set on to enter end-of-job 
processing. 
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Output-Format Specifications (Figure 5, Part 3) 


Lines 01-04; \f a permanent error occurs, a message printed 
at total time identifies the record being processed when the 
permanent error occurred. However, because of record 
blocking and the use of dual 1/O areas, all the records pre- 
ceding the record identified may not have been transmitted. 


Lines 05-10: When on, the permanent error indicator pre- 
vents the program from transmitting totals. 
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Figure 5, Transmit Only Program (Part 3 of 3) 
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Transmit with Reception of Conversational Reply 


The transmit with reception of conversational reply function 
allows the RPG I] user to transmit data to a remote terminal 
and receive a record in return. The received record will be 
made available by RPG II on the next input cycle. 


Text may or may not be received for each block of text 
transmitted. When text is received, the user cannot send 
another block of text prior to processing the received 
record. Dual 1/O areas and blocking or deblocking are not 
permitted. Matching fields are not permitted for the BSCA 
file. 


The transmit with reception of conversational reply file is 
defined as a combined file on the RPG File Description 
Specification and as a transmit file on the RPG Tele- 
communication Specifications. 


Programming Considerations 


1. A conversational reply is in effect forced by RPG II. 
That is, the reply is accepted at output time, but it is 
not available for processing at the receiving station 
until the receiving station enters the next program 
cycle. When you transmit with receipt of conversa- 
tional reply, then, be sure to review your program for 
compatibility with the RPG H Program Cycle. Do not 
expect to process a record that will not be available 
for processing or output until the next program cycle. 


2. RPG II allows only one conversational reply for each 
RPG II Program Cycle. An error halt occurs if more 
than one conversational reply is received during one 
program cycle. The program is then terminated. 

3. The records must be of equal length for both input 


and output. 


This program (Figure 6) is similar to the transmit only 
program: however, the station receiving the transmission 
can now send a response that is printed on the System/3 
printer. 


File Description Specifications (Figure 6, Part 1) 


Column Description 

7-14 WKLYSMRY is a BSC file. 

15-16 WKLYSMRY is a combined file since it will 
receive records and have records transmitted 
from it. WKLYSMRY is the secondary input 
file. 

1. End-of-file on WKLYSMRY does not deter- 
mine end-of-job time. 

19 BSC files always have a fixed length format. 

20-27 Blocking and deblocking are not permitted 
for conversational BSC files. 

40-46 BSCA is the device used for BSC files. 


Telecommunications Specifications (Figure 6, Part 1} 


Column — Description 

7-14 WKLYSMRY is the BSC file for this program. 

15-17 This station is part of a switched network (S) 
and will be transmitting with reception of 
conversational reply (T). Polling is not used, 
so column 17 is blank. 

18-19 EBCDIC code (E) and the transparency 
feature (Y) are both used. 

20-31 Autocall is used (S$), and columns 21-31 
contain the symbolic location of the dial 
number. 

32-47 Symbolic locations are given for each station 
identification sequence. Station IDs ensure 
data security on the switched network. 

53-54 The permanent error indicator used is 77. 

55-57 The telecommunications line will be kept 


open for 70 seconds even though no messages 
are being sent or received. After 70 seconds 
have elapsed, a permanent error condition 
results if the line still is not being used. 
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Figure 6. Transmit With Reception of Conversational Reply Program (Part [of 3) 





Input Specifications (Figure 6, Part 2) 


Lines 01-04: The first card read contains the dial number 
of the remote station and both station identification se- 
quences. 


Lines 08-09: A message of from | to 50 characters is 
received as a conversational reply. 
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Calculation Specifications (Figure 6, Part 3) 


If a permanent error occurs, LR is set on to enter end-of-job 
processing. 


EBM. sresstona susiess Macnine Corporation 


RPG CALCULATION 





Output-Format Specifications (Figure 6, Part 3) 


Lines 01-02: Conversational replies received are printed to 
the output file REPLY. 


Line 03: A permanent error causes an error message to be 
printed. 


Lines 04-08: Data is transmitted from WKLYSMRY. 














Punching 
Instruction 
































Factor 1 Operation Factor 2 


~ Control Levei (LO-LS, 
@ LR, SR, AN/OR) 








SPECIFICATIONS Form Gx21-8083.2 
] ] Card Etectro Number 12 sat 75 76 77 78 79 80 
ies | Fage 4] of Identification r]rlE|P LIY 

Resulting a 
Reuter rele Indicators 





Comments 
Length 



































































































































































































1718 19 20 21 22 23 24 25 26 27]28 29 30 31 32]33 34 35 36 37 38 39 5 5: 
b Ee O} rat | i ni a 4. 
ADID 3 ns un al BERR RER | it | 
ADD 4 | JEST DT 
; IT 1 
: . | HT | pa | | | I 
| ‘ 
LE HH See 
RPG OUTPUT SPECIFICATIONS Soe Cy 
IBM International Business Machine Corporatior 
: 12 75 76 77 78 79 80 
Program Punching Greshie Card Electro Number Program 
= _ ose Instruction Puneh Peat HIB] idenwtication TIREPILIy’ 
O a C]Space] Skip Output Indicators EEL [ eect 5 an 
as Vera : Plus Sign | 
5 & Field Name f > y 1 Y - Date i 
Sh] » j i K Field Edit 
Line Filename = 5 3/8 End Pp. © Bees 
8) 2a) < ae nl Positon ‘ M Suppress 
£ ela et: 3/5] cana. . 
e Alolol 54 2 |s 5| 38 Output |= Constant or Edit Word 
£ © ce < [2 2 2 *“AUIO s Record 
uw ; we 
A 
6 § 10 11 12 13 1B]19 2O}24_ 22423) 24; 25/26 {271 78] 29) 30/31 1a7 33 34 35 36 37 38 |39 }40 41 42 43444]45 46 47 48 49 50 51 52 53 54 55 56 57 5B Be 60 61 6? 63 64 65 66 67 68 GY 70[71 72 73 74 
° | | q rT ] ] Piet | Joris | TT 
. 3 MY) IN!7,7 Z 4 4 ‘ a tiegh: | Bed at Parner eer 1 4 sae 
9 el | \o bat prc ylas ae 
zs | i i: MEISISG- Pisce pel Epes eo Nish tude, SOA Need lady 
° | | Pea tele | eee lal bee te oa pry 
I Se ee Pap pet dit bohotstere| Sat ee Py | Le bes op epee 
oO | i Well a sicip. , Dp! ; | i | | 
ike ERROR o URRED | |. re it 
° : . | i i ; : : | | , i! j 
E LLNI77L | | bil, aes ee Neil eel deel att 
° | i : j | A Ue : ii i 
i SMAN pond Pe ieee 
Pt el hii. t pt. MANSU pide l st ae bons fa des, 4 se Blectl 
' 1 ! : i ! i ' | 
° | | | IRIN ae i bebe ig Alewied atoued t41 syed | 
HEM hy eee | Papel oa ‘TOTAL. |=.’ tl Ett i 
oO rt i \ leh gi ! : pop | 
Bie ene thy is ors | | Las eke be et | 
1 ° ee | Li oe) a | | | | ; tig | 
yas | i fh + { + Ry i fa | | pb tetera bebe pt ai 
1 oO | | : | HT Ty | tre 1 1 Pop we eal 
b+ spore] | ie ara Fl a Gm +44 pt - bofee ee Pe Gb peek AP ge POR ceded - 
113° jo ge | | | | ly | | i i : ee j i | | 
ote Pie hal Lest 4 | Pp ee Pttod sp pitt tba 
14, [0 jt ial | ; | Ie ! i: | , : i | 
ec GLUT HE LEE AL 
PHA} ty td +4444 t+ 7 rot t+. tet d RARE 4 - tr] 























Figure 6. Transmit With Reception of Conversational Reply Program (Part 3 of 3) 


30 


Transmit and Receive (No Conversational Reply) 


Two files are defined, one as an input file on the RPG File 
Description Specifications Sheet and as a receive file on the 
RPG Telecommunications Specifications Sheet. The other 
file is defined as an output file on the RPG File Description 
Specifications Sheet and as a transmit file on the RPG 
Telecommunications Specitications Sheet. 


Transmit and receive RPG BSC programs can be written 
three ways: 


Transmit a file, then receive a file. 

Receive a file, then transmit a file. 

Transmit interspersed with receive (System/3 to OS 
or DOS only). 


Ww roe 


Programming Considerations 


In any BSC program which transmits and receives with no 
conversational reply, columns 15 and 17-47 must be identi- 
cal in the two RPG Telecommunications Specifications 
lines. 


Transmit a File, Then Receive a File 


The receive file must not be defined as the primary input 
file on the RPG File Description Specifications Sheet. An 
L must be entered in the Last File Processed column of the 
telecommunication specification. Matching fields and the 
record available indicators may not be defined for the BSC 
files. 


System/3 in this example (Figure 7) is a tributary station 
(polling characters RR) on a multipoint network. OS or 
DOS is the contro] station (central) and polls the stations. 


System/3 reads a card file containing part numbers and 
number of parts required. The cards have been sorted into 
ascending order by part number and are sequence checked 
by specifying a matching field (M1) on the RPG Input 
Specifications Sheet. The parts information is transmitted 
to the central when the central polls the station to see if 
any data is available. OS or DOS accepts the data from 
System/3 and sends back a list of parts that are not avail- 
able. The list is printed on the System/3 printer. The L in 
column 60 of the Telecommunications Specifications Sheet 
causes the file named ANSWER to be processed after the 
other input file. Normally, any file without matching fields 
would be processed first. 
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File Description Specifications (Figure 7, Part 1} 
Column — Description 
7-14 ANSWER and REQUEST are BSCA files. 
15-17 ANSWER receives messages: therefore, it is 
an input file. It is the secondary input file, 
and determines end-of-job time. Since 


REQUEST is transmitted, it is un output file. 


19 BSCA files always have a fixed length format. 


20-27 ANSWER is not blocked; REQUEST is 
blocked. 


40-46 BSCA is the device used for BSCA files. 
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Figure 7. Transmit Then Receive Program (No Conversational Reply (Part | of 4) 


Telecommunications Specifications (Figure 7, Part 2) 


Column 


7-14 


A 


16 


18-19 


Description 


REQUEST and ANSWER are the BSCA files 
for this program. 


This station is part of a multipoint network 
(M). 


REQUEST will be transmitted (T); ANSWER 
will receive data (R). 


This station is a tributary station (T) ina 
multipoint network, and polling is used. 


EBCDIC code (E) and the transparency 
feature (Y) are both used. 


Since polling is used, these columns are blank. 


The permanent error indicator used is 66. 


Column 


55-57 


60 


61-62 


63-64 


Description 


The telecommunications line will be kept 
open for 100 seconds even though no mes- 
sages are being sent or received. After 100 
seconds have elapsed, a permanent error 
condition results if the line still is not being 
used, 


ANSWER must be the last file processed (L) 
because the sequence of the program is 
transmit a file, then receive a file. Without 
the L in column 60. ANSWER would be 
processed before PARTS, because PARTS 
has matching records. 


RR are the polling characters used by the 
control station to request data from this 
tributary station. 


The addressing characters used by the control 
station to request that this tributary station 
receive data are 99, 
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Input Specifications (Figure 7, Part 3) 


Lines 04-05: ANSWER, the secondary input file, receives 


data from the control station after REQUEST has been 
transmitted. 





r 


| 
RPG INPUT SPECIFICATIONS G2 {soe aU G80: 
IBM sca 


a —--——— pop yo RaCREG NG ly 76 #7 18 79 80 
gat 5 i od card Electeo Number Ooi 
Proutam Punching aphin / 4 
me tenes nie oe item ene = - wee eee i ' wa por meet bh ete Page 
Programmer [be NSttAC CON: Punch | ' 


Program Safes re 
Pom of TT IRIDLL (B 
sobs Sebel 7 a Eeasaabccem bas saee 


Record Identification Codes Field 
Field Location 


‘ 2 4 Indicators 






























anc 





TI 











«3 Indicator 


——S-—— 


Line | Filename Field Name 
















Luo 
Plus [Minust or 
Blank 


Position Position Position From 


To 





Fores Tye 


Control Level (L1-L9% 
Matching Fields oc 
Field Record Relation 





Character 
Chaining Fields 





BfEs 4 $6 96 bv bB}od ao 62 6 


B 


65 66 fE7 GALES ZG] 41 22 42 74 


& 
= 
& 









@ 
“la 



















































































Figure 7, Transmit Then Receive Program (No Conversational Reply) (Part 3 of 4) 


34 





Calculation Specifications (Figure 7, Part 4) 


If a permanent error occurs, LR is set on to enter end-of-job 
processing. 
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Output-Format Specifications (Figure 7, Part 4) 


Lines 01-03: Records read from PARTS are transmitted 
from REQUEST until end-of-file is reached on PARTS, and 
no more data is available for the control station. 


Lines 04-05; Records received by ANSWER are printed to 
LIST. 


Line 06: A permanent error causes an error message to be 
printed. 
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Receive a File, Then Transmit a File File Description Specifications (Figure 8, Part 1} 


Column Description 


The receive file is defined as a primary or secondary file on 7-14 GRADES and RESULTS are BSCA files. 
the RPG File Description Specifications Sheet. The record 
available indicator must be blank on the RPG Telecom- 15-16 GRADES will receive data; therefore, it is an 


munications Specifications Sheet. input file. It is the primary input file. 


RESULTS is the output file since it will be 


transmitted. 

17 End-of-file on GRADES causes LR to be 
In the following example (Figure 8) all data for a student set on, 
test given at a remote location is received by System/3. 
The first record contains the correct answers and the number 19 BSCA files always have a fixed length format. 
of questions on the test (maximum 50). All following 
records contain student answers. The correct answers and 20-27 Both files are blocked. 
the students answers are stored in arrays and compared. 
For each question the number of students that missed the 32 Dual !/O areas are used. 
question is then calculated and transmitted back to the 
remote terminal as an element of the array named RES. 40-46 BSCA is the device for BSCA files. 
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Telecommunications Specifications (Figure 8, Part 2) 


Column 


7-14 


16 


Description 


GRADES and RESULTS are the BSCA files 


for this program. 


This station is part of a switched network (S). 


GRADES is an input file and will receive 
data (R). RESULTS is an output file and 
will be transmitted (T). 


Polling is not used. so column 17 is blank. 


EBCDIC code (E) and the transparency 
teature (Y) are both used. 


Autoanswer (A) is used by the called station. 


Explicit station identification sequences are 
entered. Station IDs ensure data security 
on the switched network, 


52 Intermediate block check (1) is used. 
53-54 The permanent error indicator used is 55. 
55-57 The telecommunications line will be kept 


open for 70 seconds even though no mes- 
sages are being sent or received. After 70 
seconds have elapsed, a permanent error 
condition results if the line still is not being 
used. 


Input Specifications (Figure 8, Part 2) 


Lines 01-03: The first record received contains the number 
of questions on the test and the correct answers to the 
questions. These answers form an array, ANSARR. 


Lines 04-05: All records received after the first record 


contain students’ answers to the test questions. These 
answers form the array STDARR. 
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Figure 8. Receive Then Transmit Program (No Conversational Reply) (Part 2 of 3) 
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Calculation Specification (Figure 8, Part 3) 


Lines 01-02: Ifa permanent error occurs, LR is set on and 
Q2 is set off to enter end-of-job processing immediately, 


Lines 03-09: The array containing the correct answers 
(ANSARR) is compared an element at a time to the arrays 
formed by students’ answers (STDARR). From these 
comparisons the number of wrong answers to each question 
is computed and entered in the array RES. 


Lines 11-18: When the entire input file (GRADES) has been 
received and the LR indicator set on, RES is transmitted 
from RESULTS by exception output, one clement at a time, 
unless a permanent error occurs. 


Output - Format Specification (Figure 8, Part 3) 
Lines 01-04: RESULTS is transmitted as exception output. 


Lines 05-06: A permanent error causes an error message to 
be written. 
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Receive Then Transmit Program (No Conversational Reply) (Part 3 of 3) 
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Transmit Interspersed with Receive (S ystem/3 to OS or 
DOS Only) 


A “transmit interspersed with receive” program transmits 
data from one file and receives data in another; the data in 
the two files may or may not be related. Unlike conversa- 
tional programs, a “transmit interspersed with receive” 
program may intersperse data several records or several 
blocks at a time. 


The receive file must be defined as a Demand file on the 
RPG File Description Specification. The record available 
indicator must be defined on the RPG Telecommunication 
Specification. This method of transmission can be used 
only when System/3 is the remote terminal that initiated 
the transmission. When data is transmitted from the con- 
trol station, System/3 suspends its transmit file to receive 
the incoming data. 


Programming Considerations 


Once System/3 BSC has begun to process the last record in 
the BSCA transmit file, System/3 will ignore the record 
available indicator, whether or not the last record has 
actually been transmitted. When BSC accepts for trans- 
mission the last record in the file, RPG II completes LR 
processing and begins to close the file. 


This means that after RPG II passes the last record in the 
transmit file to BSC, RPG II completes Last Record (LR) 
processing and begins to close the file. Consequently, if 
OS or DOS requests to transmit a response to a record or 
block transmitted by System/3, the request is ignored if 
it is a response to the last record or last block in the file. 
If OS or DOS requests a response on the next-to-the-last 
record or block in the file, the request is ignored only if 
the file has already been closed. 


The System/3 programmer can avoid problems this may 
raise in a particular program by agreeing with the OS or 
DOS programmer upon a special record to be added to the 
end of the System/3 transmit file. This record would signal 
OS or DOS that System/3 has gone to end-of-job and can- 
not honor a request to receive from OS or DOS, even though 
that request may have just been transmitted. 


Page of SC21-7507-5 
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By TNL: SN21-5428 


In Figure 9, a card file containing information about a stu- 
dent test is read in and transmitted to an OS or DOS for 
processing. During transmission, OS or DOS may interrupt 
to send back results. When this occurs, RPG will turn on 
record available indicator 04. The input file is then read 
and the incoming data is printed on the printer. System/3 
then resumes transmission. 


File Description Specifications (Figure 9, Part 1} 


Column — Description 

7-14 RESULTS and GRADES are BSC files. 

15 RESULTS will receive data; therefore, it is 
an input file. GRADES will be transmitted 
and is an output file. 

16 To receive data intermittently, a BSC file 
must be a demand file. 

17 End-of-file on RESULTS does not determine 
end-of-job time. 

19 BSC files always have a fixed length format. 

20-27 Neither BSC file is blocked. 

40-46 BSCA is the device for BSC files. 
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Figure 9. Transmit Interspersed With Receive Program (No Conversational Reply) (Part 1 of 3) 
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Telecommunications Specifications (Figure 9, Part 2) 


Column 


714 


15 


16 


17 


18-19 


20-31 


Description 


RESULTS and GRADES are the BSCA files 
for this program. 


This station is part of a switched network (S). 


RESULTS is an input file and will receive 
data (R). GRADES is an output file and 
will be transmitted (T). 


Polling is not used, so column 17 is blank. 


EBCDIC code (E) and the transparency 
feature (Y) are both used. 


Autocall is used (E), and columns 21-31 
contain the dial number of the remote 
station. 


32-47 


53-54 


55-57 


58-59 


Explicit station identification sequences are 
given. Station IDs ensure data security on the 
switched network. 


The permanent error indicator used is 44. 


The telecommunications line will be kept 
open for 70 seconds even though no mes- 
sages are being sent or received. After 70 
seconds have elapsed, a permanent error 
condition results if the line still is not being 
used. 


The record available indicator is 04. It is 
set on when the remote station is ready to 
send a record to be received by RESULTS. 


Input Specifications (Figure 9, Part 2) 


Lines 07-09: RESULTS receives records from the remote 
station. These records contain a student number and the 
student’s score. Student scores are calculated by the remote 
station from the data transmitted from GRADES. 


RPG IL BSCA Programming 43 


IBM 


rv 


IBM 


a 
|i 


| 
3 


‘ 
5 
i 
1 
i 


B | 
‘IBM 
I 
 ESTUDENT AA 
aa | 
BR 


Pivure &. 


JRESULTS 


Sigsietnnd 


NRESULTS [SIRI EYE, 
GRADES ST 


Vransmii interspersed With Recebe Pre 


33 
| 


vram €No Conversational Reply) (Pari 


EXTENSION AND LINE COUNTER SPECESICATIONS 


B2 


O38 MIT RTIR OL 


ANSARR | 5@ oa BO 
STDARR 5A LO. 
RPG TELECOMMUNICATIONS SPECIFICATIONS 
ili Pee ee ees 
Rts ; i : 
baler 4 ! : 
i | 1 ' 
[eck i i 
EYE. E9676 E5678 | | HHOMOOY 
ENE E98 Te £5678 HADI 
RPG INPUT SPECIFICATIONS 
HY 


WHFQUES 
628 ANSARR 


5 STUDID 
b& STDARR 


Ss STDNT 
1® SCORE 


2of 3) 


I 
caNe See Meum! Se ade ein oe Al poh Se) 


Calculation Specifications (Figure 9, Part 3) 


Phe calculation sequence obtains the scores computed by 


the remote station from GRADES aid crakes them avail- 
able for eception ourput to PRINT. 


Lines O1-0¢0- Loop d is executed during detail tines that is. 
before end-ol-tile is reached on STUDENTS. Ween the 
remote station causes the record availuble tndicator (dp to 
be sebon. tre READ operation accepts aiecord from the 
remote station and places it in RESULTS. [ndieator 10 ts 
set on when READ encounters an end-of-file condition. 
Unuil O-4 is set off and TO is set on, records will be accepted 
to RESULES and will be availible for exception output ic 
PRINT. Poop T can be entered or re-entered auviime 04+ ts 
seton.sexcept after end-ot-file has been reached on STU: 
DENES. Therefore. after one group of reeetds tus been 
read by the receiving station, the receiving Slaton must set 
the end-ot-tile indicator (LO) otf so that the next group ot 
records may be read, 

Lines 07-42. Loop 2 is executed during total time. that is, 
after ond-ol-file has been reached on STUDENTS and the 

LR indjcatar set on. Loop 2 processes records for RESUL ES 
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Output - Format Specitications (Figure 2, Part 3} 


Lines ¢2-06; GRADS is tiatissitted to the reniote 
Staats 


Lines 07-112 Records recened by RESUE ES are printed, 


fines [2-fo0 A peymanent errear causes Gh error tiessage (0) 


he pomted. 
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Figure 9. Transmit Interspersed With Receive Program (No Conversational Reply) (Part 3 of 3) 
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Appendix A. ASCII and EBCDIC Codes 


The coded character sets for ASCII and EBCDIC are The data link control characters recognized by System/3 
shown below. Use the set that your adapter and program- are listed in Appendix B. 
ming system supports. 


ASCII Codes 






Main Storage Bit Positions 0, 1, 2, 3 
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Bit Positions 
4,5,6,7 
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Main Storage Bit Positions 0, 1, 2, 3 
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BCDIC Codes 


Main Storage 
Bit Positions 


tb 











ede et) 
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The following charagters and character sequences are 


recognized by Svstemy3 BSCA. For detailed information 
on Data Link Control Characters, see General Information 


Binary Svichronous Communications, GA27-3004. 


Name 


Start of Heading 

Start of Text 

End of Transmission Block 
End of Text 

End of Transmission 
Enquiry 

Negative Acknowledge 
Synchronous Idle 

Data Link Escape 
Intermediate Block Character 
Even Acknowledge 

Odd Acknowledge 


Watt Before Transmit Pos. Ack. 


Mandatory Disconnect 


Reverse Interrupt 

Temporary Text Delay 
Transparent Start of Text 
Transparent Intermeciate Block 
Transparent End of Text 
Transparent End of Trans. Block 
Transparent Synchronous Idle 
Transparent Block Cancel 
Transparent TTD 

Data DLE in Transparent Mode 


Mnemonic 


SOH 
STX 
ETB 
ETX 
EOT 
ENO 
NAK 
SYN 
DLE 
ITB 
ACK 0 
ACK 1 
WACK 
DISC 


RVI 
TTD 
XSTX 
XITB 
XETX 
XETB 
XSYN 
XENQ 
XTTD 
XDLE 


ASCII 





SOH 
STX 
ETB 
ETX 
EOT 
ENO 
NAK 
SYN 
DLE 
US 
DLE O 
OLE 1 
DLE; 
DLE EOT 


DLE< 
STX ENO 
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EBCDIC 
SOH 

STX 

ETB 

ETX 
EOT 
ENO 
NAK 
SYN 
DLE 

{US 

DLE (70) 
DLE/ 
DLE, 
DLE> "EOT 
DLE@ 
STX ENO 
DLE STX 
DLE 1US 
DLE ETX 
DLE ETB 
DLE SYN 
DLE ENO 
DLE STX 
DLE DLE 


DLE ENO 
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Appendix C. 


Polling and addressing are used on multipoint, nonswitched 
networks. Polling is a request to a tributary station to 
transmit data to the control station (central). Therefore, 
polling characters identifying your station must be entered 
on the RPG Telecommunications Specifications Sheet for 
the BSCA output (transmit) file. 


Addressing is a request from central to send data to your 
station. Therefore, the addressing characters must appear 
on the RPG Telecommunications Specifications Sheet for 
the BSCA input (receive) file. 


Polling and Addressing Characters for System/3 


A polling character is composed of two identical alphabetic 
characters; an addressing character is composed of two 
identical alphabetic or numeric characters. Polling and 
addressing characters must be used together in certain pairs. 
When a polling character is selected, the complementary 
addressing character must be used; when an addressing 
character is selected, the complementary polling character 
must be used. 
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Valid poling and addressing chatueters for bork EBCDIC 


and ASCH codes are given below in piurs. 





EBCDIC CODE 


Addressing Character 












































a 
to 





ASCH CODE 





Polling Character i Addressing Character 


eanes 


dd 





bb 
eit T tie ote ots 


cc 








dd 











eu 
ee Ss 
! ff 
emg fe eS nae 
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RPG It TELECOMMUNICATIONS SPECIFICATIONS 


Column 


4 


hn 


~~} 


s 





40 


Subject 


Page 
Line 
Form Type 
Comments 
File name 
Contiguration 
Type of 
station 


Ivipe ol 


control 


Ty peo code 





Transparency 


Switched 


Dial number 


Locaiton ol 
identifticution 


this station 


Identificution 


this station 


Location of 


identification 


remote station 


Identification 


remote station 


hnury 


Q1-99 


QO0-999 


Alphaimeric 


Poor blank, 


MOS 


I. biank 


ALU 
bor blank 


YON or blank 


MEL S. AL 
8. blank 


Numeric, 
alphiamertc 


Sob. blank 


Alphameric 


Sk. blank 


Alphameric 


RPG I! Teleprocessing Specifications Suiitnary 


iNxplanation 


Page number 

Line number 

Identities a telecommunication specification 
Identities a comment fine 

Name of BSCA file 


Point to point, nonswitened network, 
multipoint network, switched network 


Fransmut or receive (with or without 


conversational reply } 

Pributary station, pon-tributary 

ASCH. Grormerty referred tous USACTII). 
EBODIC 

‘Tramspareney Featitre used or not used 


Switehed or not. manual or auto answericall, 
location of dial namber if autocall 


Dial number or location of dial number 


Locauion of TD i TD) used 


{Dor docation of HD at FD used 


Location of ID if 1D used 


ID or location of TD uh TD used 
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RPG Il TELECOMMUNICATIONS SPECIFICATIONS (Continued) 


Column 


48-5] 


53-54 


55-57 


58-59 


60 


61-62 


63-64 


65-70 


71-74 


75-80 


Subject 


Remote terminal 


ITB 
Permanent 
error 
indicator 
Wait time 
Record 
available 
indicator 
Last file 
Polling 


characters 


Addressing 
characters 


Remote device 


(Reserved) 


Program 
identification 


Entry 


Blank, 

2770, 2771, 
2772, 2773, 
2774, 2780 


1, blank 


01-99, 
L1-L9, LR, 
H1-H9 


Numeric, 
blank 


01-99, 
L1-L9, LR, 
H1-H9 


L 


Alphameric 


Alphameric 


Blank, 1442-1, 
1442-2, 1443, 
0545-3, 0545-4, 
2213-1, 2213-2, 
2502-1, 2502-2, 
5496-1, 5496-2 


Alphameric 


Explanation 


Columns 48-51 are used only if the Model 10 Disk 
System, Model 12, Model 15, or Model 6 is to 
communicate with an IBM 2770 or IBM 2780 (see 
Appendix E). Otherwise, columns 48-51 are never 
used with System/3 and must be blank. 
Intermediate block check used or not 


Signal of a permanent error 


Wait time specified or assumed 


Indicates that the receiving station is 
ready to transmit 


Identifies BSCA input file to be processed 
last 


Polling identification 


Addressing identification 


Columns 65-70 are used only if the Model 10 Disk 
System, Model 12, Model 15, or Model 6 is to 
communicate with an IBM 2770 or IBM 2780 (see 
Appendix E). Otherwise, columns 65-70 are never 
used with System/3 and must be blank. 


Not used 


Name of program 


FILE DESCRIPTION SPECIFICATIONS FOR BSCA FILES 


Column 


aA 


15 


20-23 


24-27 


32 


40-46 


Subject 
File name 


File type 


File 
designation 


End of file 


File format 


Block length 


Record 
length 


Additional 
area 


Device 


Entry 
Alphameric 


1,0,C 


E, blank 


F 


Numeric 


Numeric 


1-9, blank 


BSCA 


Explanation - 
Name of BSCA file 


Input (receive), output (transmit), com- 
bined (conversational); C is invalid with 
an IBM 2770 or IBM 2780 


Demand file for transmit interspersed with 
receive or for any other use of READ with 


a BSCA file 


End-of-file used to determine end-of-job 
time 


Fixed length 

Block length of BSCA file (same as record 
length for conversational reply ); see Ap- 
pendix E for entry with IBM 2770 or IBM 
2780 


Length of BSCA records; see Appendix E 
for entry with IBM 2770 or IBM 2780 


Dual or single I/O area; dual for non- 
conversational BSCA files only 


Device for all BSCA files 
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RPG I telecommunications programming supports the 
{BM 2770 Data Communication System and the IBM 
2780 Data Transmission Terminal as remote terminals for 
the System/3 Model 10 Disk System, Model 12, Model 15, 


und Model 6. This appendix contains a description of the RPG 


I specifications required to use the IBM 2770 and the IBM 
2780, a discussion of specific System/3 considerations 
which apply when using these devices, and one sample 
RPG IE program for each device. 


Note: Before attempting to write your own RPG II pro- 
grams for using the IBM 2770 or the IBM 2780, you should 
read JBM Systems Reference Library —System Components; 
IBM 2770 Data Communication System, GA27-3013;1BM 
Systems Reference Library -IBM 2770 System Summary, 
GA27-3014; and/or JBM Systems Reference Library—IBM 
2780 Data Transmission Terminal—Component Descrip- 
tion, GA27-3005. 


RPG If SPECIFICATIONS 


Use of the IBM 2770 Data Communication System and the 
1BM 2780 Data Transmission Terminal affects RPG file 
description specifications, RPG line counter specifications. 
RPG telecommunications specifications, and RPG output- 
format specifications. Only the entries unique to the IBM 
2770 or IBM 2780 are described here. 


RPG File Description Specifications 


For each IBM 2770 or IBM 2780 device specified on the 
RPG Telecommunications Specifications sheet (see RPG 
Teleconumunications Specifications), a unique file must be 
defined on the RPG File Description Specifications sheet. 


Columns 20-27 (Block Length and Record Lengtti) 


The System/3 block length (columns 20-23) and record 
length (columns 24-27) determine the remote buffer size. 
For the IBM 2780, buffer size is always 400: for the IBM 
2770, the buffer size is as follows: 


System/3 Biock Size Remote Buffer Size 


<128 128 
> 128 258 


Telecommunications RPG IL support then blocks all records 


to ensure that the remote buffer size is never exceeded. 
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Using the IBM 2770 and the IBM 2786 


When transmitting to an IBM 2780, no more than two 
records are blocked if the ratio of block length (columns 
20-23) to record Jength (columns 24-27) is less then 2. If 
the ratio is greater than 2, no more than 7 records will be 
blocked. 


The IBM 2770 inserts a record separator (RS) character be- 
tween blocked records, but does not perform intermediate 
block checking. If you specify ITB for the JBM 2770 in 
transparent mode, System/3 issues a diagnostic. Otherwise. 
the specification is ignored for the IBM 2770. Intermediate 
block checking is always assumed for the IBM 2780. 


For record lengths supported by the remote devices you 
are using, see the appropriate Systems Reference Library 
manual. 


Ifa record received by System/3 is shorter than the record 
length specified in columns 24-27, blanks are added to the 
right. Ifa record received by System/3 is longer than the 
record length specified in columns 24-27, the record is 
truncated on the right. 


Columns 33-34 (Overflow Indicator} 

An overf.ow indicator may be specified for IBM 2770 and 
IBM 2780 printer files. 

Columns 40-46 (Device) 

The device specified in columns 40-46 of the RPG File 
Description Specification sheet is always BSCA for each 
IBM 2770 and 1BM 2780 file. The maximum number of 
files allowed within a program using BSCA files is 12. 
Other Entries 


All other valid file description specifications are accepted 
in a BSC program using the IBM 2770 or IBM 2780. 
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RPG Line Counter Specifications 


A line counter specification should be given for every IBM 
2770 and every IBM 2780 printer file. If a line counter 
specification is not given, the overflow line is set at 60 and 
the form length is set at 66. A warning is issued at com- 
pilation time for each IBM 2770 or IBM 2780 printer file 
lacking a line counter specification. 


RPG Telecommunications Specifications 
IBM 2770 files and IBM 2780 files require two additional 


entries on the RPG Telecommunications Specifications 
sheet: Remote Terminal and Remote Device. 


Columns 48-51 (Remote Terminal) 


Anerv Explanation 

2770 The remote terminal is an IBM 2770. If 
System/3 is transmitting, the output channel 
on the IBM 2770 is, by default, output chan- 
nel 1. 

2771 The remote terminal is an IBM 2770, output 
channel 1. 

Sade The remote terminal is an [BM 2770, output 
channel 2, 

2F73 The remote terminal is an IBM 2770, output 
channel 3. 

2774 The remote terminal is an [BM 2770, output 
channel 4. (Output channel 4 is an optional 
channel; if it is not available and is specified, 
a permanent error occurs.) 

2780 The remote terminal is an [BM 2780. 


Note: You cannot specify both the IBM 2770 and the 
IBM 2780 in the same program. 


Columns 65-70 (Remote Device) 





brery Remote Terminal Remote Device 

1442-1 IBM 2780 IBM 1442 Card Read/ 
Punch (card read) 

1442-2 IBM 2780 IBM 1442 Card Read/ 
Punch (card punch) 

1443 IBM 2780 IBM 1443 Printer 

0545-3 IBM 2770 IBM 0545 Card Punch, 
Model 3 

0545-4 IBM 2770 IBM 0545 Card Punch, 
Model 4 

2213-] IBM 2770 IBM 2213 Printer, 
Model | 

2213-2 IBM 2770 IBM 2213 Printer, 
Model 2 

2502-1 IBM 2770 IBM 2502 Card Reader, 





Model 1} 


2502-2 IBM 2770 IBM 2502 Card Reader, 
Model 2 
5496-1 IBM 2770 IBM 5496 Data Re- 


corder (card read) 


IBM 5496 Data Re- 
corder (card punch) 


5496-2 IBM 2770 


Before transmitting data from System/3, the System/3 pro- 
grammer must determine which output channels and/or de- 
vices are necessary to his program, and ensure that they will 
be available when required. Device selection occurs each 
time a different file is selected. 


Related RPG Telecommunications Specifications 


A designation of multipoint (M in column 15) and associated 
entries (T in column 17, addressing and polling characters in 
columns 61-64) are invalid Telecommunications Specifica- 
tions entries in a program using the IBM 2770 or IBM 2780. 
System/3 can not function as the control station in a multi- 
point network. 


All other Telecommunications Specifications entries are 
valid in a program using the IBM 2770 or the IBM 2780. 


RPG Output-Format Specifications 


Space and skip entries are restricted by the IBM 2770 and 
IBM 2780 as follows: 


e An entry of 0 or blank is not supported in column 18 
(Space After): default is to space } after. 


e The skip entry is limited to u maximum of 112 for the 
IBM 2213 Printer, Model 1 (see your system RPG II 
reference manual to enter 100-112). 


@ Tape carriage channel control is not supported (confine 
punches to channel 1). 


e Repeated 1P forms positioning cannot be used on the 
IBM 2770 and IBM 2780. 


Related Considerations 


@ The IBM 1443 Printer spaces once each time it is sel- 
ected for the [BM 2780. 


@ An escape character (X‘27°) must not be the first byte 
sent to the IBM 2780 printer if you are transmitting in 
transparent mode. 


e Each printer for the IBM 2770 and IBM 2780 resets the 
internal line count to | if the print file is reopened after 
a punch file has been transmitted to an IBM 2770 or 
IBM 2780. 


e The end-of-file card transmitted by the 5496 Data Re- 
corder trom the IBM 2770 is received by System/3 as 
data. 


@ System/3 cannot print the end-of-media character trans- 
mitted by the [BM 2780. Translate this character to 
avoid an unprintable-character halt on System/3. 


SYSTEM/3 CONSIDERATIONS 


The System/3 RPG II programmer must constantly be 
aware Of the limits imposed by the IBM 2770 and the [BM 
2780 when they are used us remote terminals. For that 
reason. a thorough reading of the following manuals is im- 
perative: 


e /BM Systems Reference Library -System Components; 
IBM 2770 Data Communication System, GA27-3013, 


e /BM Systems Reference Library--IBM 2770 System 
Summary, GA27-3014, 


and/or 


e /BM Svstems Reference Library ~ IBM 2780 Data Trans- 
mission Terminal—Component Description, GA27-3005 


The System/3 programmer must also consider: 


e@ Transmit with conversational reply and receive with con- 
versational reply are not supported with the IBM 2770 
or the IBM 2780. 


e Transmit interspersed with receive is not supported with 
the IBM 2770 or the IBM 2780. 


@ If System/3 answers an [BM 2770 or an IBM 2780 in a 
switched network, the first file referenced by System/3 
cannot be a transmit file. Use a dummy receive file to 
accommodate your particular needs if System/3 cannot 
always be programmed to call. 


e Without the auto-turnaround feature, the IBM 2780 
usually cannot transmit to System/3 and then, immedi- 
ately after the data has been transmitted, receive from 
System/3. The [BM 2780 operator cannot, in most cases, 
ready devices to receive in the short time required by 
System/3 to turn the line around from receive to trans- 
mit. In the absence of auto-turnaround, program Sys- 
tem/3 to transmit and then receive. 


@ Spacing and skipping in transparent mode usually requires 
more transmission time if an IBM 2770 or an IBM 2780 
is the remote terminal: 


IBM 2770 ~ To space or skip more than one line re- 
quires an escape sequence (command to 
printer) to be transmitted in nontrans- 
parent mode (executed by RPG II). This 
entails line turn around time and extra 
transmission time. 


IBM 2780 — To space or skip more than three lines 
requires an escape sequence (command to 
printer) to be transmitted in nontrans- 
parent mode (executed by RPG II). This 
entails line turn around time and extra 
transmission time. 
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EXAMPLES Transmitting to the [BM 2776 Data Communication Sys- 
tem 

The following two RPG II programs provide examples of 

the System/3 Model 10 Disk System or Mode! 12 using the System /3 reads the input file, CARDIN, from MEFCUI 

IBM 2770 and the IBM 2780 as remote terminals. The first (Figure 10). Uns data forms the cutput file, PUTONLY, 


program transmits data from System/3 to an IBM 2770: the that is transmitted, using the BSCA, to an [BM 2770. 
second controls the transmission of data from an {BM 2780 Transmission is in nontransparent mode. 


to System/3. 
The IBM 2770 prints PUUTONLY on an IBM 2213 Printer, 
Model |. PUTONLY is printed with a heading conditioned 
on the overflow line. 
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Receiving from an IBM 2780 Data Transmission Terminal 


An EBM 2°80 reads an input file, GETONE YY. rere 
1442 Card Read Punch (Figure bh). System 
the operation by dialing the IBM 2780 and :equesting i 
reeelve using the BSCA, The IBM 2780 then iansimits 
GETONLY to System 3 mm nontransparent ode. 


1BM 


3 intiniss 





Data received by System/3 fron: the IBM 2780 forms the 
output file PRINT. System/3 prints this file. spacing once 
after each record. 
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Appendix F. Communicating with the Operating System Telecommunications Access Method (TCAM) 


System/3 can be part of a telecommunications network that 
includes the Operating System Telecommunications Access 
Method (TCAM). (For information regarding TCAM, see 
{BM Svsren ‘360 Operating System Telecommunications 
Access Method {TCAM) Concepts and Lacilities, GE30-2022. 
and (BM Svsreny o6u Operating Svstem Teleconiununications 
elecess Method (TCAM: Programuner’s Guide and Reference 
Manual, GC30-2024,) 


Systems3 communicates with TCAM in the same Way it 
cominvaicates with another System/3 except that it cannot 
exchange conversational messages with TCAM. The System/3 
programmer may only approximate conversational mode by 
using RPG TH. 


The RPG H technique for approximating conversational 
mode vonsists of: 


@ Using the READ operation code to receive data and the 
EXCPT operation code to transmit data. 


the System/3 program so thar System/3 will perform 


@ Indicating a transmit or a receive operation via TCAM to 
I 
| the appropriate BSCA transmit or receive operation. 


Instead of using one combined file for transmitting and re- 
ceiving data, the RPG IH technique requires two files: a de- 
mand file for input from the BSCA, and another file for out- 
put to the BSCA. 


The following two sample programs use the RPG UE tech- 
nique to approximate conversational mode. System/3 is 
ihe primary station in the first sampie program (System/3 
initiates transmission to TCAM); System/3 is the remote 
station in the second sample program (TC AM initiates trans- 
nission to System/3). 
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SYSTEM/3 TO TCAM 


System/3 transmits to TCAM (Figure 12) the answers (Y or 
N) that students have given on a test. TCAM determines 
which answers are correct and which are not, and then re- 


turns the results to System/3. 


File Description Specifications 


System/3 reads student answers from MFCU]. The 
answers will be transmitted to TCAM. MFCITAB isa 

table file containing station [D’s. ANSWER and RESULTS 
are used to transmit and receive, respectively. RESULTS 
must be a demand file (D in column 16) because the READ 
operation code will be used to receive records to the file. 





| RPG CONTROL CARD AND FILE DESCRIPTION SPECIFICATIONS 





Extension Specifications 


MFC1TAB contains the tables TABME and TABYOU. 
TABME is the System/3 station ID; TABYOU is the TCAM 


station ID. 
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ANSWERS and RESULTS are wansmit and receive files. 
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input Specifications 


MFCU1 provides data from the card reader. RESULTS 
provides data from TCAM. 
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Calculation Specifications 


System /3 records the number of fests Lreusmifted £9 1AM 
for concetion. The tests are transmitted by exception out- 
put to the BSCA. System/3 receives (using the READ 

operation code) results trom FCAM until Svstemi3 reaches 


end-of-file on RESULTS. 


end-of-file time to prepare 











Output-Format Specifications 


System/3 sets indicators off at 
for the next RPS ovele. 
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READ. IRESULTS: 


RPG CALCULATION SPECIFICATIONS 
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Sestem/3 prints data by exception output as the data is 
read Jrom the card reader and received from the BSCA. 
System/3 transmits data to TCAM by exception output as 
the data is read from the card reader. System/3 signals 
TCAM (with an ‘E’) when no more records will be sent, 
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TCAM TO SYSTEM/3 Extension Specifications 


System/3 receives from TCAM (Figure 13) the answers (Y The first record from MFCU] contains station [D’s. The 
or N) that students have given on a test. System/3 deter- second record from MFCU1 is a table, MAST, containing 
mines which answers are correct and which are not, and the correct answers for the tests to be processed. Two 
then returns the results to TCAM. arrays, ANS and RES, will be built during execution of the 


program. ANS will contain answers received: RES will con- 
tain the results of a comparison of the answers received to 
File Description Specifications the correct answers in MAST. 


MFCDUMY is a dummy file and serves only to begin the 
RPG I cycle. MFCU1 is a table file, containing station 
1D’s and a table of the correct answers for the tests being 
processed. ANSWERS and RESULTS are BSCA files used 
to receive and transmit, respectively. ANSWERS must be 
a demand file (D in column 16) because the READ opera- 
tion code will be used to receive records to the file. 
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Telecommunications Specifications 


ANSWERS and RESULTS are receive and transmit files, 
respectively. Both are part of a switched network. 


Input Specifications 


ANSWERS receives data from TCAM. The character “EF” 

will identify the last record to be received (columns 26-27). 
MFCDUMY contains no data but merely begins the RPG II 
cycle and sets on indicator 39. 
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Calculation Specifications Output-Format Specifications 
After reading MFCDUMY, System/3 receives a record to 
ANSWERS, prints the record received (by exception out- 
put), determines which of the answers received are correct 
(by comparing them to the answers in MAST), and then 
prints and transmits the results (by exception output). 
After each record has been processed, System/3 prepares 
for the next RPG I cycle by setting off indicators. 


System/3 prints and transmits data by exception output. 


System/3 continues to receive and process answers until 
the last record, identified by “E’, has been processed. 


RPG CALCULATION SPECIFICATIONS Spariees 


Sigh apatertae Sosa a 1 2 Ty 16 77 78 79 80 


rr DS) een TEITIOSS] 

















Resulting 




























































Vigure 13, TCAM to System/3 (Part 3 of 5) 


~) 
to 


























oa ee 
\ i Fx era 2 | il ic Co Minus] ore) Comments 
| | | Nam {Leng C3] 7 
3 ile | Se 
7 srehafrefrepyafis 19 20.20 Soot eps 42 oe Yn ge ear fo tt ae ae 2 sala oft Si S160 6) a2 be G6 
Gl Peis. 5 eee TTT Jacl | | r eee Tb 
e Ef is PRP] LT CSSD cae! Da bis 
| £ NB | dk bid Hi Berplt sty 
[a Seas sie 2N3B). 0). ./i.).). GOTO JEND 225i: i 
81S) MBB ded bbb | eee | 
Lae ae PEP Lj |p eae | A RCRA a 
Pet deh | Wh ap dos adh ack Per AID ; 
eee TTT | dower | i trate! |]. ge 
eee 2 eee pees i]. Come) te 
a Ree ol eB | Gloro. | sc 
PALS LA as b | COMP, LL 
| 7 (ed a. | aL ee | Move, pe i i | 
PPL del LL in| bs |! MOVE: | WRONG": HSE 
Pea Ptah id i | ADD). je mae ae 
iiie.fel 4 bl GOTO LOOPIN | tt 











o paras, 
vat 
rer fone 
“Sheet a 
ses eh, ! 
i { 
pod 
pee 
tebe 
7 e web IE + = - se an ad i x. 


ee Pe Fo pote Ee OOPOU FAG, oe 
oes ST INUMQES COMP. |X. (ba. De 
MEd 26i : GOTO END 
ee STENT 6 EY 
Mi STINT OK ADD % 
di 1 TINT: : GOTO LOoOProu. : 
oe i Ramee i : iEND. : TAG... i E 
Pie ah ech EGU b GI weet REPT 5 


Fol. 6 os . SETOF: Ba 


oe hoe 
Meth 2 2h 84s 3G, BETOF . 77 3S 
ape Pe fe Nebel . GOTO READ A hy 
Ee ee ict Pe wah lets el gee) aed 

Opa ar 


RPG OUTPUT SPECIFICATIONS 
IBM 





a w TOTS 
i 

| : i 

Efe eo | 

i 2 BG 

; | : i es 4 

nia ee a Ce 

hoes ee fy ee oop ag eases = Sa mend 
ee ope | 1 3Be; j LP oe 

Ait a OR) |. OFF fF Bo 

eee Claes) ok Es & ad () 2k, ANSWERS RECEIVED AND! 


io pi dS : ' co Yi (RESULTS TRANSMITTED! 





£0). 3 





ee 65° 'LR RECORD RECEIVED 

( 7 BB: | ie ! 

epg gS ica 32 CALL TESTS PROCESSED 
ero CY DALINT: 


bg bce tig, at - INAME 2 
pe ites boy 2.) NUMQESX, | 28. | 
Lesa Pici io 2 7 3 3 VANS 79 

eS Bee eG 22 LOL ANSWERS RECEIVED’ 
| oe 2 ae OY i ' ep : 

1 


ite fh god Baw 9. DS we 


d re 


bisire P3. FOAM to Systeme 3 fPart 4 of 8) 


Comiunicuiing with ile Oysctatin: tsi Petes ati a 


RPG OUTPUT 





SPECIFICATIONS 


DB. ieee TOPOS 























< [oe =- EE 
: 
poo 4 Pisa 2 
i | ae 
eA ae 
Peres e ae 
I , ey | hips 
| oor | pany 
ae eS ae ae ee fd a bot _ os issoeeleas Hi Se ae AAs 9 SRA igi ese 
|? Fi tl) | WIINTo | i 
0. beak ly ; } ri uta? ‘ 
i hase se tat = Se GS Fy pees? eet 
ey pladfejepe)g ¢ MAME FE). 281] 
eae 2000 re oe || 35, S ANSWER # / : 
cereal | i } ! : Ko {i ; 
i‘ Tyyich de tb OS be Sa | 
iy Plepiaeeieat et a a pi Fe eee | 
le [pees ! haf 
ts Washoe ae ihe eS SIRES ae ee: a 
. EF lz} |} 76 ie 7 i 
Io! rid NAME 1) 2G). | 
° soya th ARS | Si TEST PROCESSED! 
' ye | : | ii \ 
fii i |. | 7TINTS; || 
| Jo! Pet Poot | 
bs? Io ba, cee 
| lie. fe! Pete oe 
ptt pEba de de deed cg PBS MR fp emp 
| Oi] fire l i I 
: | od | i t ; 
fo 1O4 i tj : 
: I / i f it wha Oe, bam «PR a Bee ee eos Oe a | BR A Eee ah 
jt oI bol 





fisure PA, PCAM to System3 (Part S of 8a 


TCAM CONSIDERATIONS 


Two restrietions not apparent tn the preceding examples 
must be considered when you communicate with TCAM: 


L. To avoid “unidentified record” halts, your RPG TH 
program must recognize dnd ignore any Plank records 
transmitted by TCAM. (TCAM may transmit to you 


blank records received from its Other terminals. } 


2. To maintain a switched line connection. you must begin 
trunsinitting to TCAM within nine seconds aiter 
receiving end-ol-file from TCAM. Otherwise. you must 
dial to re-establish the line connection, 


RPG II telecommunications programming supports the 
IBM 3741 Model 2 Data Station, the IBM 3741 Model 4 
Programmable Work Station, and the 5230 Model 2 Data 
Collection Controller in communicate mode as a remote 
device via the BSCA on the IBM System/3 Model 6, 
Model 8, Model 10 Disk System, Model 12, and Model 15. 
The 3741 and 5230 are also supported when locally attached 
to the System/3 Model 6, Model 10 Disk System, and 
Model 15 via the Local Communications Adapter. In 
addition, remote and local attachment is supported via 
the Integrated Communications Adapter on the IBM 
System/3 Model 8 and Model 12. 


This appendix contains a description of the RPG II 
specifications required to use the 3741 and 5230 
(identical to specifications used to receive from a 3741 
without expanded communications) and three sample 
RPG II programs. 


It is recommended that only one data set be transmitted 
from the 3741 during the execution of an RPG II pro- 
gram. If more than one data set is transmitted, erroneous 
records may be passed to the RPG II program. Data sets 
with different record lengths are not permitted, since 
only one BSCA input file can be defined. 


For more detailed explanation of transmitting data sets 
on 3741, refer to the JBM System/3 3741 Models 3 and 4 
Programmable Work Station Programming Reference 
Manual, GA21-9194, or IBM 3741 Data Station Reference 
Manual, GA21-9183. 


A 3741 with an Expanded Communications Feature (Fea- 
ture 1680) has a maximum buffer size of 512 bytes. 


The Operator Identification Card Reader Feature (Feature 
5450) and the Expanded Communications/Multipoint Data 
Link Control Feature (Feature 1685) on the 3741 are not 
supported by System/3 RPG II. 


Note: If an RPG I] program is communicating with a 3741 
and an error occurs on the 3741, the System/3 could loop 
on I/O attention. To prevent this, the RPG II program must 
use the permanent error indicator to force the application 
program to end of job or other non-BSCA operations. The 
user program should print a message if this occurs. 
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Appendix G. Using the IBM 3741 and IBM 5230 


RPG I! SPECIFICATIONS 


Use of the IBM 3741 affects RPG II file description 
specifications, RPG I] telecommunications specifications, 
and RPG II output format specifications. Only the entries 
unique to the 3741 are described here. 


RPG II File Description Specifications 


Only two BSCA files are allowed (one input and/or one 
output) per RPG II program. If two BSCA files are used, 
the input file must be processed completely before pro- 
cessing the output file. 


Column 15 (File Type) 


Entry Explanation 
I This is an input (receive) file. 
O This is an output (transmit) file. 


Columns 20-23 (Block Length) 


When using an RPG II program to communicate with a 
3741 without the expanded communication feature, the 
maximum block length is 128 bytes. 


When using an RPG II program to transmit to a 3741 with 
the expanded communications feature, the maximum 
block length is $12 data bytes plus a number of IRS 
(interrecord separator) characters equal to the blocking 
factor. The IRS characters are stripped by 3741 hard- 
ware so the block will fit into a512-byte buffer. When 
using an RPG II program to receive data from a 374] 

with the expanded communication feature, the maximum 
block size is 512 bytes. This block contains the data 
records as well as the record separator characters placed in 
the 3741 buffer before transmission. The RPG II program 
may remove or ignore the IRS character. See Expanded 
Communications Feature in the JBM 3741 Data Station 
Reference Manual, GA21-9183. 


Note: When the 3741 is in ECB transmit mode (J) it 
will block records, including the IRS characters, to get 
the maximum number of records into a 5] 2-byte buffer. 
An X*‘1E’ must be used as the IRS character when 
transmitting to the 374] (see Figures 16 and 18). 
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Columns 24-27 (Record Length) 


Maximum record length is 128 data bytes (129 bytes, which 
includes the IRS character, if expanded communications 
feature is used). 


Columns 40-46 (Device) 


BSCA is specified when 3741 attachment is via either the 
Binary Synchronous Communications Adapter or the 
Local Communications Adapter. 
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RPG tl Telecommunications Specifications 
The 3741 files require some restrictions to the telecom- 


munication specifications. Only the columns affected are 
listed here. 


Column — Entry Not Allowed Description 
15 M Multipoint network 


17 T Tributary station ona 
multipoint network 


18 A,U ASCII 


19 Y Transparency (Not 
allowed when the 
3741 is attached via 
the Local Communica- 
tions Adapter) 


52 I ITB 


Columns 61-74 must be blank. 


RPG II Output Format Specifications 


Columns 17-22 must be blank. 


EXAMPLES 


The following RPG II programs provide examples of the 
System/3 Model 10 Disk System, System/3 Model 12, and 
System/3 Model 15 using the 3741. The first program 
transmits data from the System/3 to a 3741, the second 
program receives data from a 3741, the third program 
transmits data to a 3741 with the expanded communica- 
tions feature using the expanded communications buffer, 
and the fourth program receives data from a 3741 Model 2 
and receives a status message. 
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Transmitting to the IBM 3741 


System/3 reads the input file CARDIN from MFCU1 
(Figure 14). This data forms the output file B3;CAOUT 
that is transmitted, using the BSCA, to a 3741. The 3741 
writes the data on a diskette. The printer file is used to 
indicate normal end of job and any errors. 
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‘4. Transmitting to the IBM 3741 (Part 2 of 2) 
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System/3. This data forms the input file BSCAIN. 
System; writes tie data received to the printer file 


The IBM 3741 transmits a record using the BSCA to 
PRINTER (Figure | 
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Transmitting to a 3741 with Expanded Communications 
Feature 


This program (Figure 16) shows the BITON and BITOF 
coding needed to generate the interrecord separator 
character to separate records when transmitting data toa 
3741 using the expanded communications feature. 


System/3 reads the input file DISKA from DISK. The RPG 
H program will then attach an IRS (interrecord separator) 
character to each record in this file. This forms the output 
file T3741 which is then transmitted, using BSCA, to a 
3741. The PRINT file is used to indicate any errors and 

a total card count at end of job. 
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Receiving a Status Message from an [BM 3741 Data Station 


Figure 17 shows haw Lo receive the status message fom a 
3741 Data Station wien a BSCA error has occurred. 


The IBM 3741 transmits data via the BSCA to System 3, 
This data forms the input file INBSCA. Systeni 3 then 
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Appendix H. Using RPG II in Communications Between a System/3 and the IBM 3750 


(World Trade Only) 


When a System/3 is connected to an IBM 3750 Switching Programming Procedure 

System, the RPG II telecommunication program must be 

used to code the application programs allowing message On each end of file (EOT) received from a file, the RPG II 
exchanges between the two systems. The application program must switch to read the other input file. 


program can be written for message exchange related to 


the following 3750 functions: 1. 


1. Call recording 


2. 
2. Contact monitoring under data processing system 
control | 
3. 
3. Inquiry to data processing system with recorded 
answer 
4. 


4. Real time data collection to data processing system 


Si Recorded announcement to extension under data 
processing system 


6 Transfer of recorded data to data processing system 


Communications between the System/3 and the 3750 are 
binary synchronous, point-to-point operations in trans- 
parent mode. Only the EBCDIC code can be used. The 
System/3 operates as a transmit and receive station. 


The input files will be defined as receive files on the 
RPG II telecommunications specifications. 


The output file will be defined as a transmit file on 
the RPG II telecommunications specifications. 


The exit from the RPG II program can be taken 
when the stop message is received. 


The remot device field of the RPG H telecommuni- 
cations specification must be left blank. The 3750 
is considered to be a processor by System/3 RPG II 
BSCA. 
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Appendix |. System/3 RPG II Interface to BSC Line Protocol 


This appendix is intended for a person who is knowledge- Note: During the execution of an RPG II telecommunication 
able about BSC line protocol. This person should have the program, BSC output data management delays transmission 
following information to: of each block of data until the next block is ready to be 
transmitted. This delay is necessary to allow data management 
@ Write a program for the remote location to interface to place the proper line control character (ETX) on the last 
with System/3 RPG II block of data to be transmitted. For example, the Transmit 
Multiple Files chart shows the last data block of file 1 being 
@ Write a program for the System/3 to perform a specific transmitted as a result of the user program requesting output 
sequence of line protocol to BSC file n. 


The appendix shows RPG II Binary Synchronous Communi- 
cations (BSC) line protocols and indicates which ones are 
performed automatically and which ones the RPG II 
program controls. 


Each System/3 transmission of data over the communica- 
tion line is equal to BLOCK SIZE on the BSCA’s File 
Description Specification. The size of the data blocks receiv- 
ed by System/3 is controlled by the transmitting station. 
(The asterisk in the System/3 Software/Adapter column 
indicates customer coding logic.) 








System/3 Transmitting Station ‘System/3 Software/Adapter. 


Line initialization (automatic) 





“Input from BSC file 
{automatic acknowledge) 





“Causes end of file for BSC file 
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Transmit 


System/3 System/3 Software/Adapter 


ENQ mane 





Line initialization (automatic) 





Data T anal *Output to BSC file 
B (automatic acknowledge} 


aa ACK 





Data T = “End of job 


—— ACK 
EOT mash. 
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Transmit Multiple Files 


System/3 Receiving Station System/3 Software/Adapter 








Line initialization (automatic) 





“Output to BSC file 1 
{automatic acknowledge} 





“Output to BSC file 7 


{automatic acknowledge) 


Line mitialization (automatic) 





“End of job 
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Transmit/Receive 


System/3 Receive/Transmit Station System/3 Software/Adapter 


ENQ cae Line mitialization (automatic) 





Data T i “Output to BSC file 1 
B {automatic acknowledae) 
Geen ACK 
E 
Data T cae 
B 
Geom ACK 
E 
Data T mnie “Input from BSC tile a 
x (automatic acknowledge) 
Ge ACK 
EOT cael 
Gam ENO Line initialization (automatic) 
ACK eal 


Data 


ACK 


Data 





Gam EOT “Causes end of file for BSC file 





96 


Receive/ Transmit 


System/3 Transmit/Receive Station System/3 Software/Adapter 


Gan ENO Line initialization (automatic) 








p= Data “input from BSC file 1 


{automatic acknowledge) 













“Causes end of file for BSC file 





“Output to BSC file 7 


(automatic acknowledge) 


Line initialization (automatic) 





“End of job 
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LEASED MULTIPOINT, SYSTEM/3 TRIBUTARY STATION 


Receive 





System/3 Control Transmitting Station System/3 Software/Adapter 




















Addr seg ENQ Line initialization (automatic) 







“Input from BSC file 
(automatic acknowledge) 





*Causes end of file for BSC file 
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Transmit 


System/3 Control Receiving Station System/3 Software/Adapter 


hom Polling seg ENO Line initialization (automatic) 














DataT os ‘Output to BSC file 


B (automatic acknowledge) 


an ACK 


y 


Data 





Data T == “End of job 


Gan ACK 
EOT => 
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Transmit, Receive 


100 


System/3 


Control Receive/ 
Transmit Station System/3 Software/Adapter 








Polling seg ENO Line initialization (automatic) 


“Output to BSC file 1 
(automatic acknowledge) 





“Input BSC file n 
(automatic acknowledge) 


Addr seg ENQ Line initialization (automatic) 





*Causes end of file for BSC file n 





Receive, Transmit 


Control Transmit/ 
System/3 Receive Station System/3 Software/Adapter 


Addr seg ENO Line initialization (automatic) 





“Input from BSC file 1 


“Causes end of file for BSC file 1 





*Output to BSC file n 
(Automatic acknowledge) 


Polling seq ENO Line initialization (automatic) 





“End of job 





System/3 RPG II Interface to BSC Line Protocol = 101 


POINT-TO-POINT SWITCHED LINE 
1D SEQ: SWITCHED LINE STATION IDENTIFICATION SEQUENCE OPTIONAL 


Receive, System/3 Answer Station 


System/3 Transmit Station System/3 Software/Adapter 


= 11D seq] ENO Line initialization (automatic) 


[ID seq] ACK > 





“Input from BSC file 
(automatic acknowledge) 





DLE EOT *Causes end of file for BSC file 
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Receive, System/3 Calling Station 


System/3 Transmit Station System/3 Software/Adapter 


[ID seq] ENQ <p Line initialization (automatic) 


[1D seq] ACK 





“Input from BSC file 
{automatic acknowledge) 





DLE EOT “Causes end of file for BSC file 
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Transmit, System/3 Answer Station 


System/3 Receive Station System/3 Software/Adapter 


has [1D seq] ENO Line initialization (automatic) 





(ID seq] ACK —> 





“Output to BSC file 
(automatic acknowledge) 


*End of job 


DLE EOT 
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Transmit, System/3 Calling Station 





System/3 Receive Station 


(1D seq) ENO —> 
era {ID seq] ACK 


System/3 Software/Adapter 











Line initialization (automatic) 













“Output to BSC file 
(automatic acknowledge) 





je ck 
Data T = 


Data T ie *End of job 


Se ck 
DLEEOT ==> 
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Transmit/Receive, System/3 Calling Station 


System/3 Receive/Transmit Station System/3 Software/Adapter 








[1D seq] ENO =a Line initialization (automatic) 


Gees [1D seq] ACK 





E 
Data T ass “Output to BSC file 1 
B (automatic acknowledge) 


*{nput from BSC file n 
(automatic acknowledge) 


Line initialization (automatic) 





DLE EOT *Causes end of file for BSC file n 





Transmit/Receive, System/3 Answer Station 








System/3 





Receive/Transmit Station System/3 Software/Adapter 
















<< [ID seq} ENO 
[ID seq) ACK => 





Line initialization (automatic) 













“Output to BSC file 1 
{automatic acknowledge) 










“Input from BSC file 7 
(automatic acknowledge) 






Line initialization (automatic) 


@&  vccor 








*Causes end of file for BSC file 





System/3 RPG IT Interface to BSC Line Protocol 107 


Receive/Transmit, System/3 Answer Station 


System/3 Transmit/Receive Station 


System/3 Software/Adapter 








a= [1D seq} ENO 
[ID seq} ACK —> 


DLE EQT 


Line initialization (automatic) 


“Input from BSC file 1 
(automatic acknowledge) 





*Causes end of file for BSC file 1 


*Output to BSC file” 
(automatic acknowledge) 


Line initialization (automatic) 


“End of job 





Receive/Transmit, System/3 Calling Station 





System/3 Transmit/Receive Station System/3 Software/Adapter 















[IDseq] ENO —> 





Line initialization 





(automatic) 








Gas [ID seq] ACK 








“Input from BSC file 1 
(automatic acknowledge) 






“Causes end of file for BSC file 1 


“Output to BSC file 7 
(automatic acknowledge) 


Line initialization (automatic) 


Se ck 


Data T wee 





Data T => “End of job 


ee CK 
DLE EOT ==> 
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CONVERSATIONAL MODE 


Receive with Conversational Reply 


System/3 Receive Transmitting Station System/3 Software/Adapter 


Qe ENO Line initialization 


(automatic) 











ACK _ _—_> 








E “Input BSC file 
yan DATA T (automatic acknowledge) 
Xx 
ACK amie 
E 
ae em ata T 
Xx 
See er ee 
DATA T oad *Output conversational response 
x (automatic acknowledge) 
ee 6K 
SE 
Tor an 
X X 
E “Input BSC file 


oO 
> 
4 
> 
4 


(automatic acknowledge) 





= cor *Causes end-of-tile on BSC file 





Transmit with Conversational Reply 









System/3 Transmit Receiving Station System/3 Software/Adapter 











ENQ cml 


Line initialization 
(automatic) 










E 
DATA T amie *Output to BSC file 
x (automatic acknowledge) 







“Input conversational reply 
(automatic acknowledge) 













“Output to BSC file 
(automatic acknowledge) 





DATA T cet *End of job 


EOT canis 
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LINE CONDITION-SYSTEM/3 RESPONSES 


Data Mode, System/3 Transmitting 
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System/3 System/3 Software/Adapter 


*Output from BSC file 
(automatic acknowledge) 




















System/3 recovery (automatic) 





*Output from BSC file 
(automatic acknowledge) 








System/3 recovery (automatic) 


*Output from BSC file 







System/3 recovery (automatic) 






Data2 *Output from BSC file 


ACKO (wrong ACK) 


ACKO (wrong ACK) 


ap 
= 

ENQ => 
= 

male 





Data2 System/3 recovery (automatic) 


<< ACK1 
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Data Mode, System/3 Transmitting (continued) 


System/3 System/3 Software/Adapter 


oO 


“Output from BSC file 


Time-out 


Se ck 


System/3 recovery (automatic) 
“Output from BSC file 
Sets System/3 record available indicator 


“Input to BSC file 


S&S Ackorrvi 


= eno 
e 


System/3 permanent error condition while in transmit mode 





a a Causes error indicator set if assigned for 


BSC file, otherwise halts. 
jem ak 


EOT or DLE COT > 
ma *Output from BSC file 


a “Causes error indicator set if assigned for 
Sor oP Ore ror BSC file, otherwise halts. 
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Data Mode, System/3 Receiving 
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*tnput from BSC file 
(automatic acknowledge) 































System/3 recovery (automatic) 


Input from BSC file 


System/3 recovery (automatic) 


*input from BSC file 


<= Data’ 
Time-out 
Qe eno 
ACK aaa 
Sem data’ 


System/3 recovery (automatic) 


*Input from BSC file 


System/3 recovery (automatic) 


System/3 permanent error condition while in receive mode 


Gx Data 





*Input from BSC file 









*Causes error indicator set if assigned 
for BSC file, otherwise halts. 


EOT or DLE EOT >> 


*Causes error indicator set if assigned 
for BSC file, otherwise halts. 


qe TID 
NAK ona 


m= £07 oF DLE EOT 














This glossary contains some terms that are used in this 
manual. Data processing and other communications terms 
ure defined in JBM Data Processing Glossary, GC20-1699. 


addressing: A request from the control station to a 
tributary station to receive data. 


autoanswer: A machine feature that allows a called station 
to respond automatically to a call it receives over a switched 
line. 


baud: A unit of measuring the number of data characters 
sent on a BSCA line in a given time. 


binary synchronous communication: A flexible form of 
line contrel which provides a set of rules for communica- 
tion between two devices. 


called station: A station that accepts calls. 
calling station: The station from which a call originates. 
central station: See control station. 


clocking: A procedure to control the number of data bits 
sent ona BSCA line in a given time. 


control station: The primary or controlling computer in a 
multipoint telecommunications configuration. It controls 
the sending and receiving of data. 


conversational file: A BSC file that allows receiving or 
sending data characters as an acknowledgment instead 
of the ACKO or ACK1 character. 


data link: The communications lines, modems (data sets), 
stations, terminals, and other communications equipment 
used for the transmission of data between stations. 


data link control characters: The control characters used 
by the data link and the control station to notify each 
other of their status and the status of the data sent or 
received. 


Glossary 


data link message: Data sent through BSCA using either 
EBCDIC or ASCII code. 


data mode: A time at which the BSCA is transmitting or 
receiving characters on the line. 


data set: See modem. 


disconnect timeout: An indication that the BSCA station 
you were communicating with has gone on hook or hung up. 


EBCDIC transparency: A provision that allows BSCA to 
send and receive messages containing any or all of the 256 
character combinations in the EBCDIC code, including 


data link control characters. 


error history file: A push-down stack of the last BSCA 
errors that have occurred. 


full duplex: A BSCA network that allows for simultaneous 
transmission and reception of data. 


half duplex: A two- or four-wire BSCA network that 
provides for data to be sent in only one direction at a 


given time. 


half rate: A modem feature that provides for transmitting 
or receiving data at one-half the normal rate. 


host: See control station. 

intermediate block check (ITB): A provision that allows 
for parity checking on each logical record rather than the 
total buffer when large buffers of data are received. 


line control characters: See data link control characters. 


manual answer: The machine operator makes the data 
set ready. 


manual dial: Dialing is performed by the machine operator. 


master: The BSCA station that is transmitting. 
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modem: A hardware box used to connect the BSC 
adapter to the BSC line. 


monitor mode: A time during which the BSC adapter is 
looking for synchronization characters. 


multidropped terminal: See tributary station. 


multipoint data link: More than two stations on a common 
transmission line or communication facility. Each station 
has the ability to monitor the transmission line at all times 
for activity or data that may be directed to it. 


nonswitched line: A communication link between a remote 
station and computer that does not have to be established 
by dialing. 


op end interrupt: A hardware-generated interrupt used to 
indicate the completion of the software-initiated BSCA 
input/output operations. 


point-to-point data link: A communications facility that 
connects a single remote station to the computer. 


polling: A request from the control station to a tributary 
station to transmit data. Once the tributary station has 
accepted the invitation, through recognition of its polling 
characters sent by the control station, the remote station 
may use the line to send data. 


receive timeout: An indication that no data has been 
received by this BSC adapter in a given time. 


receive initial: A software command to allow the BSC 
adapter to receive synchronization characters. 


receive mode: A time during which the BSC adapter looks 
for synchronization characters and then stores the data 
characters in main storage. 


remote terminals: Interconnected equipment at a remote 
location having either input or output capabilities or both. 


reverse interrupt: A method of sending data records from 
one BSCA station to another station before receiving 
end-of-file indication from the other station. 

slave: The BSCA station that is receiving. 

standby line: A modem feature that allows a point-to- 


point leased line modem to also function on a point-to- 
point switched line. 
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station: Any of the computers, terminals, or devices that 
use the communication facilities. 


switched line: A communication line in which the connec- 
tion between the computer and a remote station is 
established by dialing. 


transparency: See EBCDIC transparency. 


transparent mode: A BSC adapter mode initiated by the 
sequence DLE STX. 


tributary station: A secondary or noncontrolling device in 
a multipoint telecommunications configuration. 


wrap test: A diagnostic procedure that transmits a specific 
character pattern to or through the modem ina loop and 
then compares the character pattern received to what was 
transmitted. It is used when unrecoverable BSCA hardware 
errors Occur. 


access lines 5 

additional areaentry 14 

addressing § 

addressing characters 52,54 

addressing charactersentry 13 

American National Standard Code for 
Information Interchange 6, 47 

ASCII 6 

ASCII code chart 47 

autoanswer 6,10 

autocall 6,10 


block length entry 14 

block size 93 

BSC functions 15 
telecommunications concepts 3 
terminology 3 

BSCA station types 7 


central § 
code typeentry 9 
combined file 14 
comments line entry 9 
common carrier 5 
configuration entry 9 
considerations 
conversational reply 27 
programming 15 
System/3 59 
TCAM 74 
2770/2780 59 
control breaks and overflow 15 
control characters, data link 6,49 
control sequence 6 
control station 5 
control type entry 9 
conversational mode 
receive with conversational reply 110 
transmit with conversational reply 111 


Index 


Data Communication System (2770) 1,57 
dataformats 15 
data link 
control 6 
control characters 6,49 
message codes 6 
message formats 6 
data restrictions 15 
Data Station (3741) 75 
Data Transmission Terminal (2780) 1,57 
dedicated lines 5 
demand file 14 
device entry 14 
dial numberentry 10 
DOS 1,7 
dual l/O areas 14 


EBCDIC 6 

EBCDIC code chart 48 

EBCDIC transparency 6 

end-of-file entry 14 

end-of-transmission 5,6 

EOT 5,6 

errors 16 

Extended Binary Coded Decimal Interchange 
Code 6,48 


file description specifications sheet entries 17 
BSC files 13 

file designation entry 14 

file format entry 14 

file name 
file description entry 9, 13 
telecommunications entry 9 

file type entry 13 

formtype entry 8 


glossary 115 


Index 117 


identification 

remote stationentry 10 

this station entry 10 
intermediate block checking entry 11 
intermediate block checking mode 6 
ITB 6,11 


last file 
entry 12 
example 33 
leased lines 5 
leased multipoint, System/3 tributary station 
receive 98 
receive, transmit 101 
transmit 99 
transmit, receive 100 
line condition--System/3 responses 
data mode, System/3 receiving 114 
data mode, System/3 transmitting 112 
line number entry 8 
line protocol 93 
location of identification 
remote stationentry 10 
this stationentry 10 


manualanswer 6,10 
manual dial 6,10 

message codes, data link 6 
message formats, datalink 6 
multidropped terminal 5 
multipoint 5 


network control 5 

networks, telecommunications 3 
nonswitched 6 

nonswitched entry 9 
nonswitched network 5 


operating procedures | 
OSs 1,7 
overflow, control breaks and = 15 


page numberentry 8 
permanent error indicator entry 11 
point-to-point 5 
point-to-point leased line 
receive 93 
receive/transmit 97 
transmit 94 
transmit multiple files 95 
transmit/receive 96 


118 


point-to-point switched line 
ID seq: switched line station identification sequence 
optional 
receive/transmit, System/3 answer station 108 
receive/transmit, System/3 calling station 109 
receive, System/3 answer station 102 
receive, System/3 calling station 103 
transmit/receive, System/3 answer station 107 
transmit/receive, System/3 calling station 106 
transmit, System/3 answer station 104 
transmit, System/3 calling station 105 
polling 5 
polling characters 51,52 
polling characters entry 12 
private lines § 
program identification entry 13 
programming considerations 15 


READ operation code 65 
receive a file, then transmit a file program 36 
receive only program 16 
receive with transmittal of conversational reply program 20 
record available indicator 
entry 12 
use 41,65 
record length entry 14 
remote device entry 13 
remote terminal entry 10 
reserved entry 13 
RPG II 
BSCA programming 7 
diagnostics 16 
RPG telecommunications specifications sheet 8 


specifications sheet, telecommunications 8 
specifications summary, teleprocessing 53 
station identification $ 

station identification entries 10 

station identification location entries 10 
station typeentry 9 

station types, BSCA 7 

switched 5 

switched entry 10 

switched network 5 

Switching System (3750) 89 


TCAM (OS telecommunications access method) 1, 65 
TCAM considerations 74 
telecommunications 

networks 3 

specifications sheet 8 

specifications summary 53 


transmit a file, then receive a file program 31 
transmit and receive (no conversational reply) 31 
transmit interspersed with receive program 41 
transmit only program 24 
transmit with reception of conversational reply program 27 
transparency entry 9 
transparency, FBCDIC 6 
tributary station § 
type of 

codeentry 9 

controlentry 9 

station entry 9 


wait time entry 12 


2770 Data Communication System 1,57 
2780 Data Transmission Terminal 1, 57 
3741 Data Station 75 

3750 Switching System 89 
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